navapbc / template-application-nextjs

Next.js, TypeScript, USWDS, and Storybook template, including CI/CD, for teams at Nava building web applications
Apache License 2.0
10 stars 3 forks source link

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

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.

Updates

There are multiple ways to receive template updates on your project. For most updates, you can simply run the update-template.sh script

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

If the update fails the simplest option may be to re-run the installation script above and manually review the changes.

Remember: Make sure to read the release notes in case there are breaking changes you need to address.

Learn more