next-app-starter

This is a Next.js app template. It allows to bootstrap new projects with the followings features out-of-box:

• Intergation with takeda/ui package
• Appropriate code-styling with Prettier and ESLint
• CSS styling with Tailwind
• Unit testing with Vitest
• Authentication with Azure AAD
• GitHub actions for PR checks and deployment

You can check live demo here: https://tbd

Contents

• Local Development
• Branching Model
• PRs and Code Review
• Unit Testing
• E2E Testing
• Deploy Process

Local Development

1. Ensure you have Node.js v16 installed

   node -v
   

2. Clone repo

   git clone https://github.com/VitaliyPotapov/next-app-starter
   

3. Setup private npm registry
4. Install dependencies

   npm i
   

5. Create a .env.local file with local environment variables

   tbd
   

6. Run development server

   npm run dev
   

7. Open http://localhost:3000

Branching Model

This project uses trunk-based development. There are the following branches:

• main - long-lived branch with actual codebase
• release/x.x - release branches for pre-production code-freeze, regression testing and deploy
• all other branches are short-lived feature branches named as prj-xxx-new-feature

PRs and Code Review

• Target your pull-requests to main branch
• Request code review using GitHub
• Get at least 1 approve before merge

Unit Testing

tbd

E2E Testing

tbd

Deploy Process

tbd