Fullstack Templates Collection

Production-ready stack templates with TypeScript, SCSS, and modern backends

Available Templates

Default Stack: FastAPI + React

Full-stack web application with Python FastAPI backend and React 19 frontend. Uses compose.yml and dev.compose.yml.

Go-Chi Stack: Go + React

Full-stack web application with Go Chi backend and React 19 frontend. Uses compose.go.yml and dev.compose.go.yml. Backend located in alternate-backends/go-chi/.

iOS Mobile: Expo + React Native

Mobile application using Expo and React Native. Located in mobile/ios-expo/. Connects to any backend via API (no Docker required).

---

Setup

Option 1: GitHub Template (Recommended)

Click the "Use this template" button above, or:

gh repo create my-project --template CarterPerez-dev/fullstack-template
cd my-project

Option 2: Clone

git clone https://github.com/CarterPerez-dev/fullstack-template.git my-project
cd my-project
rm -rf .git && git init

Prerequisites (Optional but Recommended)

Install just command runner:

curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash -s -- --to ~/bin

Then add ~/bin to your PATH if not already.

Installation

chmod +x setup.sh
./setup.sh

Or if you have just:

just setup

This will:

• Copy .env.example → .env with generated SECRET_KEY
• Move template files (LICENSE, CONTRIBUTING, etc.) to root
• Install backend dependencies (uv sync)
• Install frontend dependencies (pnpm install)

Next Steps

For FastAPI + React (Default)

1. Edit .env with your configuration
2. Start development: just dev-up or docker compose -f dev.compose.yml up
3. After creating models: just migration-local "initial" then just migrate-local head

For Go-Chi + React

1. Edit .env with your configuration
2. Start development: docker compose -f dev.compose.go.yml up
3. Production: docker compose -f compose.go.yml up

For iOS Expo App

1. Navigate to mobile/ios-expo/
2. Follow the iOS-specific README for Expo setup
3. Configure API endpoint to connect to your backend

Run just to see all available commands.

---

Documentation

Comprehensive guides for understanding and customizing this template:

Backend

• Backend Architecture

  Complete backend architecture including FastAPI setup, security patterns (JWT + Argon2id), database models, repository pattern, services, API endpoints, testing, and production deployment.

Frontend

• Frontend Architecture

  React 19 + TypeScript architecture with TanStack Query, Zustand state management, complete design system (OKLCH colors), API integration patterns, SCSS utilities, and performance optimizations.

Infrastructure

• Nginx Configuration

  Reverse proxy setup, rate limiting, WebSocket proxying, caching strategies, security headers, and performance tuning for both development and production.

• Docker & Compose

  Multi-stage Dockerfiles, health checks, network segmentation, resource limits, security hardening, and complete containerization guide.

---

License

MIT License - see - LICENSE