Next.jsReact启动器

uswds_nextjs_starter — Next.js 启动器模板

作者 adhocteam

基于 React 与 Next.js 的 USWDS 起步项目，用于快速搭建或原型化美国网页设计系统站点，并内置无障碍检查与 GitHub Pages 部署流程。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图
桌面端首页1 / 2
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-13查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

01

使用 React 与 Next.js 构建 USWDS 站点，README 定位为快速起步与原型化

02

每次 push 通过 GitHub Pages 工作流自动部署

03

手动构建命令为 npm run export，产物位于 out 目录

04

CI 运行 ESLint（core web vitals 预设）、Lighthouse CI 与 axe，无障碍不达标会失败

05

修改 uswds-settings.scss 中的 USWDS 设置可在开发模式下即时编译生效

06

README 列出两个同类仓库：纯 HTML 的 uswds_html_starter 与 Next.js 模板 template-application-nextjs

模板详细介绍

该仓库的目标是让使用者尽快用 React 搭建一个简单的 USWDS（US Web Design System）站点，适合新建站点或快速原型。README 说明它通过 GitHub Pages 在每次 push 时自动部署，部署工作流位于 .github/workflows/github-pages.yml；手动构建可运行 npm run export，产物输出到 out 目录。开发时先运行 npm install，再运行 npm run dev 启动带热重载的开发服务器。每次 push 的 CI 任务会运行 ESLint（core web vitals 预设）、Lighthouse CI（无障碍得分不是 100% 则失败，配置在 .github/lighthouse 目录）以及 axe（有未通过项则失败）。修改 assets/stylesheets/uswds-settings.scss 中的 USWDS 设置后，开发模式服务器会在编译完成时反映改动。README 未提供具体框架版本号、组件清单、路由结构或除 GitHub Pages 之外的部署方式说明。

Next.jsReact启动器

适合你的项目吗？

适用场景

  • 快速搭建一个使用 USWDS 的 React 站点原型
  • 在项目中引入无障碍自动化检查（Lighthouse CI 与 axe）
  • 通过 GitHub Pages 自动发布静态站点
  • 在开发过程中调整 USWDS Sass 变量并即时查看效果

适合人群

  • 希望以 React 和 Next.js 起步 USWDS 站点的开发者
  • 需要带无障碍 CI 检查的静态站点起步模板的团队
  • 计划用 GitHub Pages 托管演示或原型的项目

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

  1. 1

    运行 npm install 安装依赖

  2. 2

    运行 npm run dev 启动带热重载的开发服务器

  3. 3

    运行 npm run export 手动构建，产物在 out 目录

  4. 4

    USWDS 设置修改位于 assets/stylesheets/uswds-settings.scss

  5. 5

    自动部署依赖 .github/workflows/github-pages.yml，CI 配置位于 .github/workflows/ci.yml 与 .github/lighthouse 目录

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

  • 允许免费使用、修改、商用和分发该版本代码。
  • 分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
  • 代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文
https://github.com/adhocteam/uswds_nextjs_starter/blob/main/LICENSEhttps://github.com/adhocteam/uswds_nextjs_starter/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-13。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 77 / 100
技术栈
Next.js · React
网站类型
启动器
这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2024-07-25
截图检查日期
2026-10-13

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: codex-user-requested-batch-review-20261015 · 2026-10-15

查看当时使用的来源资料

SHA-256: 658ab1c941079b5fdd6818615bc3a0271488f07dc3776dc6bb842c1048540f2c

2026-10-13T17:17:42.390Z

来源文件 / 仓库
# USWDS NextJS Starter

This repository aims to get you up and running with a simple [US Web Design
System](https://designsystem.digital.gov/) site using React as quickly and
simply as possible, to facilitate new sites or easy prototyping.

Visit the page that this site generates at
[https://adhocteam.github.io/uswds_nextjs_starter/](https://adhocteam.github.io/uswds_nextjs_starter/)

## Deployment

This repository deploys to GitHub pages on every push, via [this workflow
job](.github/workflows/github-pages.yml).

To build it manually, run `npm run export`, and you will find the site in the
`out` directory

## Development

Run `npm install` then `npm run dev` to turn on the dev server with hot reloading

## Accessibility

On every push, the [CI job](.github/workflows/ci.yml):

- runs ESLint with the reasonably strict [core web vitals](https://nextjs.org/docs/basic-features/eslint#core-web-vitals) preset
- runs [Lighthouse CI](https://github.com/treosh/lighthouse-ci-action) and fails if the accessibility score isn't 100%
  - config is located in the `.github/lighthouse` directory
- runs [axe](https://www.npmjs.com/package/@axe-core/cli) and fails if anything doesn't pass

Check out [accessibility.digital.gov](https://accessibility.digital.gov) for
good resources on why this is so important

## Changing USWDS sass variables

If you update any [uswds
settings](https://designsystem.digital.gov/documentation/settings/) in [the
uswds settings sass file](assets/stylesheets/uswds-settings.scss) while you're
running the dev mode server, you'll see your changes reflected in the page as
soon as it compiles.

## Contributing

This repo accepts contributions! Just file a PR.

Feel free to create a discussion topic if you have an idea and you want
feedback on it before starting to work on it.

## Similar repositories

- [adhocteam/uswds_html_starter](https://github.com/adhocteam/uswds_html_starter) is a similar USWDS starter project, but using plain HTML
- [navapbc/template-application-nextjs](https://github.com/navapbc/template-application-nextjs) is a similar template app with Next.js + React and a somewhat different focus
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

ai-website-cloner-template

ai-website-cloner-template

Clone any website with one command using AI coding agents

Next.js · 启动器

Next.js SaaS Starter

Next.js SaaS Starter

Next.js SaaS Starter 是 Next.js 官方维护的 SaaS 起点模板，定位介于学习资源和可直接部署的脚手架之间。

Next.js · SaaS

Next.js Commerce

Next.js Commerce

Next.js Commerce 是 Vercel 团队维护的电商启动模板，基于 Next.js App Router 构建，采用服务端渲染、React Server Components、Server Actions …

Next.js · 电商

Next-js-Boilerplate

Next-js-Boilerplate

Next-js-Boilerplate 是一个面向 Next.js 16、Tailwind CSS 4 和 TypeScript 的启动器，核心定位是开发者体验优先。

Next.js · 启动器

tailwind-nextjs-starter-blog

tailwind-nextjs-starter-blog

tailwind-nextjs-starter-blog 是一个面向个人技术博客的 Next.js 与 Tailwind CSS 启动模板，其 v2 版本基于 App Router 与 React Server Comp…

Next.js · 博客

next-forge

next-forge

Production-grade Turborepo template for Next.js apps.

Next.js · 启动器