From 77b167c695ac1d6d082695033125c5e5770d299f Mon Sep 17 00:00:00 2001 From: behnam Date: Mon, 17 Mar 2025 11:02:06 +0300 Subject: [PATCH] doc: Add base readme for the project --- README.md | 25 ++++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e215bc4..ef9259e 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,27 @@ -This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app). +# Nextjs clean architecture boilerplate + +## Table of content + +- Overview +- Technologies +- Architecture +- Folder Structure +- Getting started +- Guildline + +## Overview +This project is a starting point for your medium to large scale projects with Nextjs, to make sure having a structured, maintainable and reusable base for your project based on best practices in clean architecture, DDD approach for business logics, MVVM for the frontend part, storybook and vitest for testing logics and ui part and also functional programming with error handling for business logics. + +## Motivation +Nextjs and many other new SSR tools provide a really good and new approach to handle frontend applications, with new tools to bring a new good experience for users. But as they're new and they just tried to bring new tools and features and also frontend community, didn't talk about software engineering and best practices approach for this tools. + +So in many cases we see many teams uses nextjs to just use its tools and features as much as they can but they don't care about the best practices, architecture and software engineering approach. So there are many projects with Nextjs which is not maintainable and specially in medium to large scale applications, through the time it'll be really hard to manage to even impossible to add new features and it cause business failures. + +So I decided to make a base firm and maintanable boilerplate for most faviorite SSR framework, which is Nextjs and use all my experiences and best practices which fits Nextjs features and abilities to make a structured, robust and maintanable basement for SSR projects. + +I personally used this boilerplate for several enterprise web-applications and it's completely tested and you can rest assured to use it safely. + +> Note: I'll be happy to get your issues and problems or any other opinion to make it better together. To know how to contribute please visite the CONTRIBUTE.md file. ## Getting Started