From 6287634a34ef65f250ece7364e829fc9ee8bd207 Mon Sep 17 00:00:00 2001
From: ulises-jeremias <ulisescf.24@gmail.com>
Date: Thu, 16 Jul 2026 03:19:00 -0300
Subject: [PATCH] docs: CONTRIBUTING for uv/Typer/PyPI

Closes #53

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 CONTRIBUTING.md | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index ead6021..daa07cd 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,3 +1,27 @@
-# Fixtures
+# Contributing to Create Awesome Python App
 
-Local stub templates live under `fixtures/` for CI `file://` scaffolding tests.
+Thanks for contributing! Please follow the [Code of Conduct](./.github/CODE_OF_CONDUCT.md).
+
+## Local development
+
+```bash
+git clone https://github.com/Create-Python-App/create-python-app.git
+cd create-python-app
+uv sync --group dev
+uv run pre-commit install
+make test
+make lint
+make typecheck
+```
+
+## Pull requests
+
+1. Branch from `main`
+2. Keep changes focused; link an issue
+3. Use [Conventional Commits](https://www.conventionalcommits.org/)
+4. Ensure tests/lint/typecheck pass
+5. Fill out the PR template
+
+## Templates
+
+Template bank work will live in `cpa-templates` (tracked in #44). Until then use `fixtures/`.