Next.jsReactStarter

nextjs-boilerplate — Next.js Starter Template

By felipe-jm

A Next.js and React starter template integrating lint-staged, husky, ESLint, Prettier, Jest, commitlint, commitizen, Storybook, styled-components, next-pwa, and plop, released under the MIT license.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews
Author preview
Author-provided preview

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-03View source

What stands out

A quick read of the recorded project description.

01

Integrates ESLint, Prettier, husky, and lint-staged for code linting, formatting, and pre-commit checks

02

Integrates commitlint and commitizen to enforce and guide commit message formatting

03

Includes Jest for unit testing and Storybook for component documentation and preview

04

Uses styled-components for styling and provides PWA support via next-pwa

05

Provides plop component generation commands to generate component, style, story, and test files at once

Template Details

This is a starter template for Next.js projects by felipe-jm, released under the MIT license. Its focus is not on page design but on pre-wiring common engineering tools: code linting and formatting (ESLint, Prettier), pre-commit checks (husky, lint-staged), commit message conventions (commitlint, commitizen), unit testing (Jest), component documentation (Storybook), styling (styled-components), PWA support (next-pwa), and component scaffolding (plop).

There are two ways to use it: click Use this template on GitHub to generate a new repository, or run yarn create next-app -e with the repository URL to create a project. The template also provides the yarn generate <component-name> command, which generates a component directory containing index.tsx, stories.tsx, styles.ts, and test.tsx.

The materials do not specify dependency versions, Node runtime requirements, build and deployment processes, or script descriptions beyond component generation. The template itself contains no business pages or design system; styling and visual design must be determined independently. Licenses for third-party assets (such as images, fonts, icons) must be verified separately, and external services like domains and hosting may incur additional charges.

Next.jsReactStarter

Is it right for your project?

Use Cases

  • Starting a new Next.js project and wanting code standards, commit conventions, and testing toolchain out of the box
  • Teams needing a unified commit message format and pre-commit check process
  • Writing Storybook documentation for React components with accompanying unit tests
  • Adding PWA capabilities to a Next.js application

Suitable For

  • Teams or individuals developing front-end projects with Next.js and React
  • Engineering teams that value code standards, commit conventions, and component documentation
  • Developers who want to quickly initialize a project via template and then add business code themselves

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Can generate a new repository via GitHub's Use this template, or run yarn create next-app -e https://github.com/felipe-jm/nextjs-boilerplate to create a project

  2. 2

    Use yarn generate <component-name> to generate a component directory containing index.tsx, stories.tsx, styles.ts, and test.tsx

  3. 3

    The repository is released under the MIT license; when distributing copies or substantial portions of the code, retain the copyright notice and license notice

  4. 4

    The materials do not list dependency versions or Node environment requirements; before installation and running, refer to the repository's actual configuration

  5. 5

    Third-party assets such as demo images, fonts, and icons must be checked against their respective licenses; external services like domains and hosting may incur additional charges

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version from a public repository under the MIT license; the free scope applies to that version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as-is; warranties and liability limitations are governed by the original license and applicable law.

Additional costs & items to verify

  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis

Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
Partly documented · 74 / 100
Technologies
Next.js · React
Website type
Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2025-03-28
Screenshot last checked
2026-10-03

No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.

The catalog identifies Next.js as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: ef77368a95f92a5255eea16269483036178a8ab0138b24225270dd2ce498d3b4

2026-10-03T05:50:22.707Z

Source file / repository
<h1 align="center">
    <br>
    Next.js Boilerplate
</h1>

<h4 align="center">
  Simple Next.js boilerplate with lint-staged, husky, eslint + prettier, jest, commitlint + commitizen, storybook and styled-components.
</h4>

<p align="center">
  <img alt="GitHub top language" src="https://img.shields.io/github/languages/top/felipe-jm/nextjs-boilerplate">

  <img alt="GitHub language count" src="https://img.shields.io/github/languages/count/felipe-jm/nextjs-boilerplate">

  <img alt="Repository size" src="https://img.shields.io/github/repo-size/felipe-jm/nextjs-boilerplate">

  <a href="http://commitizen.github.io/cz-cli/">
    <img alt="Commitizen friendly" src="https://img.shields.io/badge/commitizen-friendly-brightgreen.svg">
  </a>

  <a href="https://github.com/felipe-jm/nextjs-boilerplate/commits/master">
    <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/felipe-jm/nextjs-boilerplate">
  </a>

  <a href="https://github.com/felipe-jm/nextjs-boilerplate/issues">
    <img alt="Repository issues" src="https://img.shields.io/github/issues/felipe-jm/nextjs-boilerplate">
  </a>

  <img alt="GitHub" src="https://img.shields.io/github/license/felipe-jm/nextjs-boilerplate">
</p>

<p align="center">
  <a href="#rocket-technologies">Technologies</a>&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;
  <a href="#memo-license">License</a>
</p>

![Cover](https://res.cloudinary.com/dqcqifjms/image/upload/v1615131441/felipejung/nextjs-boilerplate-cover.png)

## :rocket: Technologies

- [React.js](https://reactjs.org)
- [Next.js](https://nextjs.org)
- [lint-staged](https://github.com/okonet/lint-staged)
- [husky](https://typicode.github.io/husky)
- [eslint](https://eslint.org)
- [prettier](https://prettier.io)
- [jest](https://jestjs.io)
- [commitlint](https://commitlint.js.org)
- [commitizen](http://commitizen.github.io/cz-cli/)
- [storybook](https://storybook.js.org)
- [lint-staged](https://github.com/okonet/lint-staged)
- [styled-components](https://www.styled-components.com)
- [next-pwa](https://github.com/shadowwalker/next-pwa)
- [plop](https://plopjs.com)

## :information_source: How To Use

To use this template you can simply click in **[Use this template](https://github.com/felipe-jm/nextjs-boilerplate/generate)** or create your Next.js app based on this template by running:

```bash
yarn create next-app -e https://github.com/felipe-jm/nextjs-boilerplate
```

## :gear: Generating components

```bash
yarn generate Button
```

Result:

```
└── components
    └── Button
        ├── index.tsx
        ├── stories.tsx
        ├── styles.ts
        └── test.tsx
```

## 🤝 Contributing

1. Fork this repository;
2. Create your branch: `git checkout -b my-awesome-contribution`;
3. Commit your changes: `git commit -m 'Add some awesome contribution'`;
4. Push to the branch: `git push origin my-awesome-contribution`.

**After your pull request is merged**, you can safely delete your branch.

## :memo: License

This project is under the MIT license. See the [LICENSE](https://github.com/felipe-jm/nextjs-boilerplate/blob/master/LICENSE) for more information.

---

Made with much :heart: and :muscle: by Felipe Jung :blush: <a href="https://www.linkedin.com/in/felipe-jung/">My Contact</a>
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.