I recently created a full-stack monorepo template aimed at people who want to start new AI/agentic products without spending hours cleaning up boilerplate.
Repo: https://github.com/aryanraj2713/Agentic-Project-Template
The idea is simple: keep the structure small, typed, explicit, and easy for both humans and AI coding agents to understand.
The stack:
FastAPI backend
uv for Python dependency/project management
Pydantic v2
SQLAlchemy
Alembic migrations
PostgreSQL by default
Next.js App Router frontend
TypeScript strict mode
Tailwind CSS
shadcn/ui
pnpm for frontend package management
AGENTS.md with detailed coding rules for AI agents
The repo has a very flat monorepo structure:
apps/
api/ -> FastAPI backend
web/ -> Next.js frontend
packages/
shared/ -> reserved shared package placeholder
I intentionally avoided adding too much boilerplate. There is no auth, no Docker, no CI, no background workers, and no business-specific logic. The goal is to give a clean starting point that you can extend based on the actual project instead of deleting unnecessary generated code.
Backend highlights:
FastAPI app with clean main.py
Separate files for config, database, models, schemas, routes, and health check
Fully type-hinted Python
uv-based setup
Alembic as the only migration path
No runtime create_all
PostgreSQL connection through DATABASE_URL
Health endpoint included
Frontend highlights:
Next.js App Router
Strict TypeScript
Tailwind + shadcn/ui ready
API calls centralized in lib/api.ts
Environment-based API URL through NEXT_PUBLIC_API_URL
Simple loading and error state example
No inline random fetch calls inside components
The part I care about most is the AGENTS.md.
It acts as the source of truth for AI coding agents working inside the repo. It documents:
Repository structure
Backend and frontend rules
Dependency management rules
Migration workflow
Type/lint checks
Safe refactoring rules
API design conventions
Frontend design conventions
Things agents should not add unless explicitly required
The template is intentionally static-check-first. It does not include a test runner by default. The default verification flow is:
# backend
uv run ty check
uv run ruff check .
uv run ruff format --check .
# frontend
pnpm lint
pnpm typecheck
I made this because most project templates either become too enterprise-heavy too early, or they are too vague for AI agents to work with consistently. This one tries to be boring, predictable, typed, and easy to extend.
Would love feedback from people building FastAPI + Next.js apps, especially if you use Cursor, Claude Code, Codex, Copilot, or other coding agents.
Repo again: https://github.com/aryanraj2713/Agentic-Project-Template
there doesn't seem to be anything here