navapbc / template-application-nextjs

Next.js, TypeScript, USWDS, and Storybook template, including CI/CD, for teams at Nava building web applications

Template Next.js React application

This is a template repository for a React web application using the Next.js framework.

See navapbc/platform for other template repos.

Features

• Framework for server-side rendered, static, or hybrid React applications
• TypeScript and React testing tools
• U.S. Web Design System for themeable styling and a set of common components
• Type checking, linting, and code formatting tools
• Storybook for a frontend workshop environment

Repo structure

├── .github             # GitHub workflows and repo templates
├── app                 # Web application
├── docs                # Project docs and decision records

Installation

To get started using the template application on your project:

1. Run the download and install script in your project's root directory.

   curl https://raw.githubusercontent.com/navapbc/template-application-nextjs/main/template-only-bin/download-and-install-template.sh | bash -s

   This script will:

   1. Clone the template repository
   2. Copy the template files into your project directory
   3. Remove any files specific to the template repository, like this README.

2. Follow the steps in app/README.md to set up the application locally.

3. Optional, if using the Platform infra template: Follow the steps in the template-infra README to set up the various pieces of your infrastructure.

Getting started

Now that you're all set up, you're now ready to get started.

Learn more

• Dependency management
• Deployment