init-repo

Generate a DDD monorepo scaffold with FastAPI, SQLAlchemy, and React.

25|5|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/Hedgehogues/awesome-claude --skill init-repo-hedgehogues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-repo
Source: https://github.com/Hedgehogues/awesome-claude/tree/main/skills/init-repo
Command: npx skills add https://github.com/Hedgehogues/awesome-claude --skill init-repo-hedgehogues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize a DDD monorepo scaffold that builds backend (FastAPI, SQLAlchemy) and frontend (React) with a ready-to-run project structure, making it easy to start new domains.

Core Features & Use Cases

  • Scaffolds root orchestration (Makefile, docker-compose) and a multi-layer backend (domain/entity, repository, use case, infra repo, routes, schemas)
  • Seeds frontend with API client, router, UI kit seed, and test infrastructure for both backend and frontend
  • Generates a test-ready skeleton (unit and architecture tests) and a clear guide to run checks

Quick Start

Run make check from the repository root to validate the scaffold.

Frequently Asked Questions about init-repo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a DDD monorepo with FastAPI and React?

To scaffold a DDD monorepo, this tool generates a complete full-stack project structure with a FastAPI backend and React frontend. It creates bounded contexts with domain, application, infrastructure, and presentation layers, plus a Makefile and docker-compose configuration for immediate orchestration.

What is a DDD monorepo scaffold and when do I need one?

A DDD monorepo scaffold is a pre-configured project structure applying Domain-Driven Design principles across backend and frontend codebases. You need one when starting a new full-stack project that requires strict separation of domain logic, application use cases, and infrastructure from day one.

Can I generate a FastAPI backend with domain, repository, and use case layers automatically?

Yes, you can generate a FastAPI backend with automated multi-layer architecture. The scaffold creates directories for domain entities, repositories, use cases, infrastructure repositories, routes, and schemas, ensuring your backend follows DDD structural patterns without manual setup.

What is the best way to start a new full-stack project with bounded contexts?

The best way to start a full-stack project with bounded contexts is using a scaffold that pre-configures the DDD layers and frontend seeds. This approach provides a ready-to-run structure with API clients, routers, and test infrastructure, eliminating boilerplate setup and ensuring architectural consistency.

How do I validate a generated DDD monorepo scaffold after setup?

To validate a generated DDD monorepo scaffold, run the command 'make check' from the repository root. This executes the starter test infrastructure, running both unit tests and architecture tests to verify that the backend and frontend layers are correctly structured.

Does the generated frontend seed include testing infrastructure and API clients?

Yes, the generated React frontend seed includes testing infrastructure and a pre-configured API client. It also provides a router and UI kit seed, ensuring the frontend is fully integrated with the FastAPI backend and ready for immediate development and testing.