An open API service indexing awesome lists of open source software.

https://github.com/everton-dgn/boilerplate_nextjs_app

This project is a complete Next.js boilerplate, constantly updated, configured in the smallest details to serve as the basis for large professional projects that intend to scale.
https://github.com/everton-dgn/boilerplate_nextjs_app

commitlint eslint hooks husky jest nextjs prettier react rtl storybook typescript vitest

Last synced: about 1 year ago
JSON representation

This project is a complete Next.js boilerplate, constantly updated, configured in the smallest details to serve as the basis for large professional projects that intend to scale.

Awesome Lists containing this project

README

          

![GitHub](https://img.shields.io/github/license/everton-dgn/boilerplate_nextjs_app?style=plastic)
![GitHub repo size](https://img.shields.io/github/repo-size/everton-dgn/boilerplate_nextjs_app?style=plastic)
![GitHub Repo stars](https://img.shields.io/github/stars/everton-dgn/boilerplate_nextjs_app?color=yellow&style=plastic)

Boilerplate Complete and updated with Next.js, Typescript, Tests and more


# :memo: About the Project

This application is a boilerplate for complex and large systems, especially those that need to scale with security and code quality.

We sought to achieve 3 pillars: readability, reusability, and refactorability.

In the construction of the UI, the Atomic Design structure was chosen, organizing the global components into atoms, molecules, organisms and templates.

In addition to being constantly updated, this project was configured in the smallest details to serve as a basis for professional projects that require standardized and easy-to-maintain code architecture and design.


---

# :pushpin: Contents

- [Technologies](#globe_with_meridians-technologies)
- [Features](#triangular_flag_on_post-features)
- [Prerequisites](#white_check_mark-prerequisites)
- [How to install and run the project](#question-how-to-install-and-run-the-project)
- [Clone Repository](#clone-repository)
- [Install Dependencies](#install-dependencies)
- [Start Development Environment](#start-development-environment)
- [Generate Production Build](#generate-production-build)
- [Start Production Environment](#start-production-environment)
- [Run Tests](#run-tests)
- [Run Tests in Watch Mode](#run-tests-in-watch-mode)
- [Run Lints](#run-lints)
- [Format code with prettier](#format-code-with-prettier)
- [Check for Available Updates for Dependencies](#check-for-available-updates-for-dependencies)
- [Important Considerations](#rotating_light-important-considerations)
- [Author](#technologist-author)


---

# :globe_with_meridians: Technologies

βš› Next.js

πŸ”₯ TypeScript

πŸ’… CSS Modules

🚩 Lints: Lefthook, BiomeJS and Commitlint

βœ… Vitest

πŸ™ React Testing Library


---

# :triangular_flag_on_post: Features

- [x] Responsive design;

- [x] Atomic Design;

- [x] 100% coverage;

- [x] Detection prefers-reduced-motion;


---

# :white_check_mark: Prerequisites

- node (latest version lts).

- pnpm (latest version lts).


---

# :question: How to install and run the project

## Clone Repository

```bash
git clone https://github.com/everton-dgn/boilerplate_nextjs_app.git
```

## Install Dependencies

```bash
pnpm i
```

## Start Development Environment

```bash
pnpm dev
```

Available in http://localhost:3000

## Generate Production Build

```bash
pnpm build
```

## Start Production Environment

```bash
pnpm start
```

Available in http://localhost:3000

## Run Tests

```bash
pnpm test
```

## Run Tests in Watch Mode

```bash
pnpm test:w
```

Available in http://localhost:6006

## Run Lints

```bash
pnpm lint
```

```bash
pnpm typecheck
```

## Format code with BiomeJS

```bash
pnpm format
```

## Check for Available Updates for Dependencies

```bash
pnpm check:update
```


---

# :technologist: Author

By [Γ‰verton Toffanetto](https://programadordesucesso.com).

:link: LinkedIn: https://www.linkedin.com/in/everton-toffanetto

:link: YouTube: https://youtube.com/@toffanettodev