Init Repo

For Python Projects

Core Stack:

• Package manager: uv
• Build system: Hatchling
• Linting/Formatting: Ruff (unified)
• Type checking: MyPy
• Testing: Pytest with asyncio support
• Git hooks: pre-commit

Directory Structure:

project/
├── src/
│   └── project_name/
│       ├── __init__.py
│       └── __main__.py
├── tests/
│   ├── __init__.py
│   └── conftest.py
├── pyproject.toml           # All config in one file
├── .pre-commit-config.yaml
├── Makefile
├── .gitignore
└── .vscode/settings.json

Requirements Gathering

Ask these questions one at a time. Wait for the user's response before proceeding.

1. Project type (ask first): "What type of project are you initializing?"

   • JavaScript/TypeScript (monorepo with Turbo, pnpm, ESLint, Prettier)
   • Python (uv, Ruff, MyPy, Pytest)

2. Project name (ask second):

   • If argument is provided, use that as the project name and skip this question
   • Otherwise ask: "What is the project name? (This will be used for the directory and package names)"

3. For JS/TS only - Scope (ask third): "What npm scope/namespace should packages use? (e.g., @mycompany, @projectname, or leave blank for no scope)"

4. For JS/TS only - Initial apps (ask fourth): "What apps do you want to create initially?"

   • Next.js web app
   • Node.js service
   • Both
   • None (packages only)

5. For Python only - Project type (ask third): "What type of Python project is this?"

   • CLI application
   • Library/package
   • Service/API
   • General purpose

Implementation: JavaScript/TypeScript

After gathering requirements, create the following:

1. Root Configuration Files

package.json:

{
  "name": "PROJECT_NAME",
  "private": true,
  "packageManager": "[email protected]",
  "scripts": {
    "build": "turbo run build",
    "dev": "turbo run dev",
    "lint": "turbo run lint",
    "format": "prettier --write \"**/*.{ts,tsx,js,jsx,mjs,json,md,yml,yaml}\" && turbo run format",
    "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,mjs,json,md,yml,yaml}\"",
    "type-check": "turbo run type-check",
    "test": "turbo run test",
    "test:coverage": "vitest run --coverage",
    "clean": "turbo run clean && rm -rf node_modules",
    "prepare": "husky"
  },
  "devDependencies": {
    "husky": "^9.1.0",
    "lint-staged": "^16.0.0",
    "prettier": "^3.5.0",
    "turbo": "^2.3.0",
    "typescript": "^5.0.0",
    "vitest": "^2.1.0"
  }
}

pnpm-workspace.yaml: