Next.js + Bootstrap Boilerplate is a code boilerplate that scaffolds a Next.js application with Bootstrap styling, TypeScript, Yarn, and Terraform-based deployment to AWS serverless infrastructure.
What is the Next.js + Bootstrap Boilerplate?
The Next.js + Bootstrap Boilerplate is a starter repository automatically generated by the Goldstack template of the same name. It produces a working Next.js project in the packages/app-nextjs-bootstrap folder, complete with TypeScript project references, Yarn workspace configuration, and Terraform deployment files. You supply AWS credentials and two domain settings (hosted zone domain and website domain); the output is a deployable website hosted on low-cost, highly scalable AWS serverless infrastructure. The project is maintained by the Goldstack open-source project and lives on GitHub.
Key Features
- Next.js application — A ready-to-run Next.js app inside packages/app-nextjs-bootstrap, started locally with yarn watch.
- Bootstrap styling — The project uses Bootstrap for its UI, so responsive components and styling are included from the start.
- TypeScript with project references — TypeScript is preconfigured with project references, and yarn build checks that every reference is correct.
- Yarn workspaces — The repo is a Yarn workspace; running yarn installs all dependencies and leaves you on Yarn 3.0.0+.
- Terraform and AWS deployment — Infrastructure-as-code files let you deploy to AWS serverless hosting with the command yarn infra up prod.
- Local development server — yarn watch in the app folder starts a live development server for fast iteration.
- Open-source and forkable — The README explicitly invites forking and modifying the repository for your own needs.
Who should use the Next.js + Bootstrap Boilerplate?
- Web developers starting a Next.js site — skip manual setup of TypeScript, ESLint, Prettier, and Yarn by forking this ready-made project.
- Developers deploying to AWS — get a Terraform-based path to serverless hosting by updating two domain fields and running a single deploy command.
- Goldstack users — use this repository as a reference or regenerate a customized boilerplate through the Goldstack project builder.
- Open-source contributors — fork the repository, raise issues, and submit feedback to the Goldstack GitHub project.
What can you do with the Next.js + Bootstrap Boilerplate?
- Launch a styled website quickly: clone the repo, run yarn and yarn watch, and have a Bootstrap-themed Next.js site running locally in minutes.
- Deploy to your own domain: set hostedZoneDomain and websiteDomain in goldstack.json, configure an AWS API key user, and run yarn infra up prod.
- Create a customized boilerplate: use the Goldstack project builder at goldstack.party/build to generate a variant built for your project.
How does the Next.js + Bootstrap Boilerplate work?
The README documents a nine-step onboarding flow: fork and clone the repository, install Node v20+, Yarn v1.22.5+, Docker v20+, Terraform CLI, and AWS CLI v2, run yarn to install dependencies, run yarn build to verify TypeScript project references, configure VSCode with the recommended ESLint, Prettier, and ZipFS extensions, initialise the workspace TypeScript version, run yarn watch for local development, update the deployment configuration, and finally deploy with yarn infra up prod.
FAQ
What dependencies are required?
You need Node v20+, Yarn v1.22.5+, Docker v20+, Terraform CLI, and AWS CLI v2. The README asks you to confirm these with node -v, yarn -v, and docker --version before continuing.
How do I deploy this boilerplate to AWS?
Configure an AWS API key user in /config/infra/config.json, then edit packages/app-nextjs-bootstrap/goldstack.json to set hostedZoneDomain and websiteDomain and delete the tfStateKey value. Run yarn infra up prod from the package folder to deploy.
Can I fork and modify this boilerplate?
Yes. The README states you are free to fork the repository and modify it for your needs, and it links to the Goldstack GitHub for questions, ideas, and contributions.
Which folder contains the Next.js app?
The main application lives in packages/app-nextjs-bootstrap. Run yarn watch inside that folder to start the local development server.
What is Goldstack?
Goldstack is a project builder that generates boilerplates for serverless web projects. This repository was automatically generated using the Next.js + Bootstrap template version 0.1.0.
