A modern monorepo template combining Next.js and FastAPI applications with Turborepo-like structure.

This monorepo includes the following packages/apps:

• dashboard: a Next.js app for the main dashboard
• web: a Gatsby app for the landing page
• api-hono: a Hono API server
• fastapi-app: a FastAPI backend for AI functionality

• @repo/ui: a React component library shared by both web and docs applications
• @repo/eslint-config: eslint configurations (includes eslint-config-next and eslint-config-prettier)
• @repo/typescript-config: tsconfig.jsons used throughout the monorepo

• packages-py: Python packages shared across FastAPI applications

• Node.js >= 18
• Python >= 3.9
• uv (Python package manager)

1. Clone the repository:

git clone https://github.com/your-org/100xtemplates-core.git cd 100xtemplates-core

2. Install Node.js dependencies:

npm install

3. Initialize Python environment:

npm run py:init

4. Start development servers:

# Start all services npm run dev # Or start specific services npm run dev -- --filter=web npm run dev -- --filter=docs npm run py:dev

• npm run build - Build all apps and packages
• npm run dev - Develop all apps and packages
• npm run lint - Lint all code
• npm run format - Format all code

• npm run py:init - Initialize Python virtual environment and install dependencies
• npm run py:dev - Start FastAPI development server with hot reload
• npm run py:build - Install/update Python dependencies
• npm run py:test - Run Python tests
• npm run py:lint - Run all Python linting tools
• npm run py:format - Format Python code
• npm run py:check - Run Ruff checks
• npm run py:clean - Remove Python virtual environment

. ├── apps/ │ ├── api-hono/ # Hono API server │ ├── dashboard/ # Next.js dashboard app │ ├── fastapi-app/ # FastAPI backend app │ └── web/ # Gatsby web app ├── packages/ │ ├── auth/ # Authentication utilities │ ├── db/ # Database utilities │ ├── ui/ # Shared React components │ ├── eslint-config/ # ESLint configurations │ └── typescript-config/ # TypeScript configurations ├── packages-py/ # Shared Python packages ├── deployments/ # Deployment configurations ├── docker/ # Docker configurations ├── pyproject.toml # Python project configuration └── package.json # Node.js project configuration 

1. Configure Environment Variables

   • Create .env files for each app
   • Set up database connections and API keys

2. Set Up Database

   • Configure SQLAlchemy models in fastapi-app
   • Set up Alembic migrations

3. Add Authentication

   • Implement JWT or OAuth2 authentication
   • Set up protected routes

4. Add API Documentation

   • Configure FastAPI OpenAPI documentation
   • Add API examples and descriptions

5. Set Up CI/CD

   • Configure GitHub Actions or similar
   • Set up automated testing and deployment

6. Add Monitoring

   • Set up logging
   • Configure error tracking
   • Add performance monitoring

Turborepo can use Remote Caching to share cache artifacts across machines.

To enable Remote Caching:

npx turbo login npx turbo link

• Turborepo Documentation
• FastAPI Documentation
• Next.js Documentation
• uv Documentation