|
1 |
| -# Next.js Enterprise Boilerplate |
| 1 | +<img align="right" width="360px" height="410px" src="./.github/assets/project-logo-vertical.png"> |
2 | 2 |
|
3 |
| - |
| 3 | +# Next.js Enterprise Boilerplate </br> [![GitHub Actions Workflow Status][check-workflow-badge]][check-workflow-badge-link] [![GitHub License][github-license-badge]][github-license-badge-link] [![GitHub contributors][github-contributors-badge]][github-contributors-badge-link] [![Discord][discord-badge]][discord-badge-link] [![Blazity][made-by-blazity-badge]][made-by-blazity-badge-link] |
4 | 4 |
|
5 | 5 | Welcome to the _Next.js Enterprise Boilerplate_, an open-source template for enterprise projects! It's loaded with features that'll help you build a high-performance, maintainable, and enjoyable app. We've done all the heavy lifting for you, so sit back, relax, and get ready to conquer the world with your incredible app! 🌍
|
6 | 6 |
|
7 |
| -<br /> |
8 |
| -<a href="https://discord.gg/fyWtyNKmfX" style="width: 100%; display: flex; justify-content: center;"> |
9 |
| - <img src="https://discordapp.com/api/guilds/1111676875782234175/widget.png?style=banner2" alt="Blazity Discord Banner"/> |
10 |
| -</a> |
11 |
| -<br /> |
| 7 | +> [!NOTE] |
| 8 | +> **Blazity** is a group of Next.js/Jamstack/Headless experts. Contact us at [contact@blazity.com](https://blazity.com) if you’d like to talk about your project or just to have a chat with us |
12 | 9 |
|
13 |
| -## 📚 Features |
| 10 | +## Features |
14 | 11 |
|
15 | 12 | With this template, you get all the awesomeness you need:
|
16 | 13 |
|
17 | 14 | - 🏎️ **[Next.js](https://nextjs.org/)** - Fast by default, with config optimized for performance (with **App Directory**)
|
18 | 15 | - 💅 **[Tailwind CSS](https://tailwindcss.com/)** - A utility-first CSS framework for rapid UI development
|
19 | 16 | - ✨ **[ESlint](https://eslint.org/)** and **[Prettier](https://prettier.io/)** - For clean, consistent, and error-free code
|
20 | 17 | - 🛠️ **[Extremely strict TypeScript](https://www.typescriptlang.org/)** - With [`ts-reset`](https://github.com/total-typescript/ts-reset) library for ultimate type safety
|
21 |
| -- 📊 **[Bundle analyzer plugin](https://www.npmjs.com/package/@next/bundle-analyzer)** - Keep an eye on your bundle size |
22 |
| -- 🧪 **[Jest](https://jestjs.io/)** and **[React Testing Library](https://testing-library.com/react)** - For rock-solid unit and integration tests |
23 |
| -- 🎭 **[Playwright](https://playwright.dev/)** - Write end-to-end tests like a pro |
24 |
| -- 📕 **[Storybook](https://storybook.js.org/)** - Create, test, and showcase your components |
25 |
| -- 🌬️ **Smoke Testing** and **Acceptance Tests** - For confidence in your deployments |
26 |
| -- 📝 **[Conventional commits git hook](https://www.conventionalcommits.org/)** - Keep your commit history neat and tidy |
27 |
| -- 🔍 **[Observability](https://opentelemetry.io/)** - Open Telemetry integration for seamless monitoring |
28 |
| -- 🎯 **[Absolute imports](https://nextjs.org/docs/advanced-features/module-path-aliases)** - No more spaghetti imports |
29 |
| -- ⚕️ **[Health checks](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/)** - Kubernetes-compatible for robust deployments |
30 |
| -- 🧩 **[Radix UI](https://www.radix-ui.com/)** - Headless UI components for endless customization |
31 |
| -- 💎 **[CVA](http://cva.style/)** - Create a consistent, reusable, and atomic design system |
32 |
| -- 🤖 **[Renovate BOT](https://www.whitesourcesoftware.com/free-developer-tools/renovate)** - Auto-updating dependencies, so you can focus on coding |
33 |
| -- 🩹 **[Patch-package](https://www.npmjs.com/package/patch-package)** - Fix external dependencies without losing your mind |
34 |
| -- 📈 **Components coupling and cohesion graph** - A tool for managing component relationships |
35 | 18 | - 🚀 **[GitHub Actions](https://github.com/features/actions)** - Pre-configured actions for smooth workflows, including Bundle Size and performance stats
|
36 |
| -- 🤖🧠 **[Automated ChatGPT Code Reviews](https://openai.com/chatgpt)** - **Stay on the cutting edge with AI-powered code reviews!** |
37 | 19 | - 💯 **Perfect Lighthouse score** - Because performance matters
|
38 |
| -- 🚢 **[Semantic Release](https://github.com/semantic-release/semantic-release)** - for automatic changelog |
39 |
| -- 💻 **[T3 Env](https://env.t3.gg/)** - Manage your environment variables with ease |
| 20 | +- **[Bundle analyzer plugin](https://www.npmjs.com/package/@next/bundle-analyzer)** - Keep an eye on your bundle size |
| 21 | +- **[Jest](https://jestjs.io/)** and **[React Testing Library](https://testing-library.com/react)** - For rock-solid unit and integration tests |
| 22 | +- **[Playwright](https://playwright.dev/)** - Write end-to-end tests like a pro |
| 23 | +- **[Storybook](https://storybook.js.org/)** - Create, test, and showcase your components |
| 24 | +- **Smoke Testing** and **Acceptance Tests** - For confidence in your deployments |
| 25 | +- **[Conventional commits git hook](https://www.conventionalcommits.org/)** - Keep your commit history neat and tidy |
| 26 | +- **[Observability](https://opentelemetry.io/)** - Open Telemetry integration for seamless monitoring |
| 27 | +- **[Absolute imports](https://nextjs.org/docs/advanced-features/module-path-aliases)** - No more spaghetti imports |
| 28 | +- **[Health checks](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/)** - Kubernetes-compatible for robust deployments |
| 29 | +- **[Radix UI](https://www.radix-ui.com/)** - Headless UI components for endless customization |
| 30 | +- **[CVA](http://cva.style/)** - Create a consistent, reusable, and atomic design system |
| 31 | +- **[Renovate BOT](https://www.whitesourcesoftware.com/free-developer-tools/renovate)** - Auto-updating dependencies, so you can focus on coding |
| 32 | +- **[Patch-package](https://www.npmjs.com/package/patch-package)** - Fix external dependencies without losing your mind |
| 33 | +- **Components coupling and cohesion graph** - A tool for managing component relationships |
| 34 | +- **[Automated ChatGPT Code Reviews](https://openai.com/chatgpt)** - **Stay on the cutting edge with AI-powered code reviews!** |
| 35 | +- **[Semantic Release](https://github.com/semantic-release/semantic-release)** - for automatic changelog |
| 36 | +- **[T3 Env](https://env.t3.gg/)** - Manage your environment variables with ease |
40 | 37 |
|
41 | 38 | ## Table of Contents
|
42 | 39 |
|
43 | 40 | - [Next.js Enterprise Boilerplate](#nextjs-enterprise-boilerplate)
|
44 |
| - - [📚 Features](#-features) |
| 41 | + - [Features](#features) |
45 | 42 | - [Table of Contents](#table-of-contents)
|
46 |
| - - [🎯 Getting Started](#-getting-started) |
47 |
| - - [🚀 Deployment](#-deployment) |
48 |
| - - [📃 Scripts Overview](#-scripts-overview) |
49 |
| - - [🔗 Coupling Graph](#-coupling-graph) |
50 |
| - - [🧪 Testing](#-testing) |
| 43 | + - [Getting Started](#-getting-started) |
| 44 | + - [Deployment](#-deployment) |
| 45 | + - [Scripts Overview](#-scripts-overview) |
| 46 | + - [Coupling Graph](#-coupling-graph) |
| 47 | + - [Testing](#-testing) |
51 | 48 | - [Running Tests](#running-tests)
|
52 | 49 | - [Acceptance Tests](#acceptance-tests)
|
53 | 50 | - [Smoke Testing](#smoke-testing)
|
54 |
| - - [🎨 Styling and Design System](#-styling-and-design-system) |
| 51 | + - [Styling and Design System](#-styling-and-design-system) |
55 | 52 | - [CVA - A New Approach to Variants](#cva---a-new-approach-to-variants)
|
56 |
| - - [💾 State Management](#-state-management) |
| 53 | + - [State Management](#-state-management) |
57 | 54 | - [Zustand](#zustand)
|
58 | 55 | - [Jotai](#jotai)
|
59 | 56 | - [Recoil](#recoil)
|
60 |
| - - [🤖 ChatGPT Code Review](#-chatgpt-code-review) |
61 |
| - - [💻 Environment Variables handling](#-environment-variables-handling) |
62 |
| - - [🤝 Contribution](#-contribution) |
63 |
| - - [💌 Support](#support) |
64 |
| - - [📜 License](#-license) |
| 57 | + - [ChatGPT Code Review](#-chatgpt-code-review) |
| 58 | + - [Environment Variables handling](#-environment-variables-handling) |
| 59 | + - [Contribution](#-contribution) |
| 60 | + - [Support](#support) |
| 61 | + - [License](#-license) |
65 | 62 | - [Contributors](#contributors)
|
66 | 63 |
|
67 | 64 | ## 🎯 Getting Started
|
@@ -270,6 +267,13 @@ Contributions are always welcome! To contribute, please follow these steps:
|
270 | 267 |
|
271 | 268 | If you're looking for help or simply want to share your thoughts about the project, we encourage you to join our Discord community. Here's the link: [https://blazity.com/discord](https://blazity.com/discord). It's a space where we exchange ideas and help one another. Everyone's input is appreciated, and we look forward to welcoming you.
|
272 | 269 |
|
| 270 | +<br /> |
| 271 | +<a href="https://discord.gg/fyWtyNKmfX" style="width: 100%; display: flex; justify-content: center;"> |
| 272 | + <img src="https://discordapp.com/api/guilds/1111676875782234175/widget.png?style=banner2" alt="Blazity Discord Banner"/> |
| 273 | +</a> |
| 274 | +<br /> |
| 275 | +
|
| 276 | +
|
273 | 277 | ## 📜 License
|
274 | 278 |
|
275 | 279 | This project is licensed under the MIT License. For more information, see the [LICENSE](./LICENSE) file.
|
@@ -302,3 +306,17 @@ This project is licensed under the MIT License. For more information, see the [L
|
302 | 306 | <!-- prettier-ignore-end -->
|
303 | 307 |
|
304 | 308 | <!-- ALL-CONTRIBUTORS-LIST:END -->
|
| 309 | +
|
| 310 | +<!-- Badges and links --> |
| 311 | +
|
| 312 | +[check-workflow-badge]: https://img.shields.io/github/actions/workflow/status/blazity/next-enterprise/check.yml?label=check |
| 313 | +[github-license-badge]: https://img.shields.io/github/license/blazity/next-enterprise?link=https%3A%2F%2Fgithub.com%2FBlazity%2Fnext-enterprise%2Fblob%2Fmain%2FLICENSE |
| 314 | +[github-contributors-badge]: https://img.shields.io/github/contributors/blazity/next-enterprise?link=https%3A%2F%2Fgithub.com%2FBlazity%2Fnext-enterprise%2Fgraphs%2Fcontributors |
| 315 | +[discord-badge]: https://img.shields.io/discord/1111676875782234175?color=7b8dcd&link=https%3A%2F%2Fblazity.com%2Fdiscord |
| 316 | +[made-by-blazity-badge]: https://img.shields.io/badge/made_by-Blazity-blue?color=FF782B&link=https://blazity.com/ |
| 317 | +
|
| 318 | +[check-workflow-badge-link]: https://github.com/Blazity/next-enterprise/actions/workflows/check.yml |
| 319 | +[github-license-badge-link]: https://github.com/Blazity/next-enterprise/blob/main/LICENSE |
| 320 | +[github-contributors-badge-link]: https://github.com/Blazity/next-enterprise/graphs/contributors |
| 321 | +[discord-badge-link]: https://blazity.com/discord |
| 322 | +[made-by-blazity-badge-link]: https://blazity.com/?utm_source=nextenterprise&utm_medium=github |
0 commit comments