Turborepo + Next.js + Strapi Boilerplate

Boilerplate By Gede Dewo Wahyu M.W ❤️

Boilerplate Description 📖

This monorepo is a full‑stack boilerplate built with Turborepo, featuring a Next.js application and a Strapi CMS. It includes authentication, theme management, state management, form validation, and Storybook, and it follows Atomic Design principles for component organization.

Installation 🚀

To get started, follow these steps:

1. Clone the repository

   git clone https://github.com/your-username/Fullstack-Boilerplate.git
   cd Fullstack-Boilerplate

2. Install dependencies (root)

   pnpm install

3. Set up environment variables

   cp apps/nextjs/.env.example apps/nextjs/.env.local
   cp apps/strapi/.env.example apps/strapi/.env

4. Start development (via Turborepo)

   pnpm dev

5. Access the applications

   • Next.js application: http://localhost:3000
   • Strapi Admin/API: http://localhost:1337

6. API Access Settings

   Authenticated

   • Data: find, findOne, update
   • Media Library: all
   • Users-permissions: me, update

   Public

   • Data: find, findOne, create
   • Users-permissions: findOne, update

Commit Guidelines 📝

When committing changes with pnpm commit, follow these steps:

1. Prepare your changes
   Ensure your code is tested and complies with the project's coding standards.

2. Stage your changes
   Stage all relevant files:

   git add .

3. Run the commit command
   Execute:

   pnpm commit

4. Follow the interactive prompt
   Select the appropriate change type (e.g., feature, fix, docs) when prompted.

5. Optionally provide a scope
   If relevant, specify the scope (e.g., a specific module or feature).

6. Write a concise subject
   Use the imperative mood and keep it short and clear.

7. Optionally add a detailed body
   Include motivation, context, and implementation details if helpful.

8. Document breaking changes (if any)
   Clearly list any breaking changes in the designated section.

9. Confirm your commit
   Review the message and confirm when prompted.

Following these guidelines ensures commit messages are informative and consistent with the project's standards.

Contribution 🤝

If you would like to contribute, follow these steps:

1. Fork the repository
   Click the "Fork" button at the top right of the repository page.

2. Clone your fork
   Clone your forked repository to your local machine:

   git clone https://github.com/your-username/Fullstack-Boilerplate.git
   cd Fullstack-Boilerplate

3. Create a new branch
   Create a branch for your feature or bug fix:

   git checkout -b your-feature-branch

4. Make your changes
   Implement your changes and ensure they follow the project's standards.

5. Commit your changes
   Commit with a descriptive message:

   pnpm commit

6. Push to your fork
   Push your branch to your forked repository:

   git push origin your-feature-branch

7. Open a pull request
   In the original repository, click "New Pull Request", select your branch, and submit with a clear description.

Thank you for contributing!

MIT License ⚖️

This project is licensed under the MIT License. See the LICENSE file for details.

How to Ask Questions ❓

If you have questions about the boilerplate or how to use it, follow these guidelines:

1. Be clear and concise
   Clearly state your question or issue and provide enough context.

2. Include relevant details
   Share specific errors, code snippets, or configurations that are relevant.

3. Search before asking
   Review the documentation and existing issues to avoid duplicates.

4. Use proper formatting
   Use code blocks when sharing code or error messages for readability.

5. Be respectful
   Be polite and respectful in all communication.

Following these guidelines helps ensure your questions are understood and answered promptly.

This documentation provides an overview of the boilerplate, installation steps, commit guidelines, and contribution process. If you have further questions, feel free to ask!