Brocoders Boilerplate Setup

Comprehensive guide for setting up full-stack applications using:

• Backend: NestJS Boilerplate
• Frontend: Extensive React Boilerplate

Quick Start

1. Choose Your Git Provider

Ask user which platform they want to use:

• GitHub → See references/github-setup.md
• GitLab (Cloud) → See references/gitlab-setup.md
• GitLab (Self-Hosted) → See references/gitlab-selfhosted-setup.md

2. Project Structure Decision

Ask user about repository strategy:

• Monorepo: Both frontend and backend in single repository
• Polyrepo: Separate repositories for frontend and backend (recommended for larger teams)

Setup Workflow

Step 1: Clone Boilerplates

# Create project directory
mkdir my-fullstack-app && cd my-fullstack-app

# Clone backend
git clone https://github.com/brocoders/nestjs-boilerplate.git backend
cd backend && rm -rf .git && cd ..

# Clone frontend
git clone https://github.com/brocoders/extensive-react-boilerplate.git frontend
cd frontend && rm -rf .git && cd ..

Step 2: Initialize Git

Based on chosen provider, follow the corresponding reference guide.

Step 3: Environment Setup

See references/environment-setup.md for:

• Backend environment configuration
• Frontend environment configuration
• Docker setup
• Database initialization

Step 4: CI/CD Configuration

CI/CD templates available per provider in their respective reference files.

Boilerplate-Specific Guides

• NestJS Backend Details → references/nestjs-boilerplate.md
• React Frontend Details → references/react-boilerplate.md

Decision Tree

Start
  │
  ├─► Git Provider?
  │     ├─► GitHub → references/github-setup.md
  │     ├─► GitLab Cloud → references/gitlab-setup.md
  │     └─► GitLab Self-Hosted → references/gitlab-selfhosted-setup.md
  │
  ├─► Monorepo or Polyrepo?
  │     ├─► Monorepo → Single repo setup in chosen provider guide
  │     └─► Polyrepo → Separate repos setup in chosen provider guide
  │
  └─► Environment Setup → references/environment-setup.md

Reference Files

• references/github-setup.md - GitHub setup
• references/gitlab-setup.md - GitLab Cloud setup
• references/gitlab-selfhosted-setup.md - Self-hosted GitLab setup
• references/environment-setup.md - Environment configuration
• references/nestjs-boilerplate.md - NestJS backend details
• references/react-boilerplate.md - React frontend details
• references/kubernetes-manifests.md - K8s manifests
• references/helm-charts.md - Helm charts