feat: root virtual uv workspace (#11)

.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+dist/
+*.egg-info/

README.md

@@ -3,3 +3,29 @@
 Composable scaffolding CLI for production-ready Python apps.
 
 > **Status:** bootstrapping. Roadmap: [#1](https://github.com/Create-Python-App/create-python-app/issues/1).
+
+## Monorepo layout (uv workspaces)
+
+This repository is a **virtual uv workspace**: the root is not published; packages live under `packages/*` and share one `uv.lock` / `.venv`.
+
+```text
+create-python-app/ # virtual workspace root (no [project] table)
+├── pyproject.toml # [tool.uv.workspace] members = ["packages/*"]
+├── uv.lock
+├── .venv/ # shared environment (gitignored later)
+└── packages/
+ ├── create-python-app-core/ # scaffolding engine
+ └── create-awesome-python-app/ # CLI (depends on core via workspace)
+```
+
+### Setup
+
+```bash
+# Requires uv: https://docs.astral.sh/uv/
+uv sync
+```
+
+### Reference
+
+- [uv workspaces handbook](https://pydevtools.com/handbook/how-to/how-to-set-up-a-python-monorepo-with-uv-workspaces/)
+- Node parity: [Create-Node-App/create-node-app](https://github.com/Create-Node-App/create-node-app)

packages/create-awesome-python-app/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "create-awesome-python-app"
+version = "0.0.0"
+description = "Composable scaffolding CLI for production-ready Python apps (stub)"
+requires-python = ">=3.12"
+dependencies = [
+ "create-python-app-core",
+]
+
+[tool.uv.sources]
+create-python-app-core = { workspace = true }
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/create_awesome_python_app"]

packages/create-awesome-python-app/src/create_awesome_python_app/__init__.py

@@ -0,0 +1,3 @@
+"""Create Awesome Python App CLI."""
+
+__version__ = "0.0.0"

packages/create-python-app-core/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "create-python-app-core"
+version = "0.0.0"
+description = "Scaffolding engine for Create Awesome Python App (stub)"
+requires-python = ">=3.12"
+dependencies = []
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/create_python_app_core"]

packages/create-python-app-core/src/create_python_app_core/__init__.py

@@ -0,0 +1,3 @@
+"""Scaffolding engine for Create Awesome Python App."""
+
+__version__ = "0.0.0"

pyproject.toml

@@ -0,0 +1,5 @@
+# Virtual workspace root — not a publishable package.
+# See: https://pydevtools.com/handbook/how-to/how-to-set-up-a-python-monorepo-with-uv-workspaces/
+
+[tool.uv.workspace]
+members = ["packages/*"]