Files
chicken_babies_site/docs
Phillip Tarrant f77da87eaa feat: phase 1 public site skeleton — layout, routes, CSS, logo pipeline
Ship base Jinja layout (header/nav/main/footer with skip link and aria-current),
mobile-first single-file CSS using the ROADMAP palette tokens, and four public
routes: /, /about, /contact, /shop. Blog index renders via a stable
PostService.list_published() stub returning [] — Phase 2 only swaps the body.
About is static placeholder copy, /contact ships an inert form plus a mailto:
link driven by ADMIN_CONTACT_EMAIL, /shop shows a "Coming soon" card.

Adds a Pillow-based scripts/generate_static_assets.py producing resized logo
PNG + WebP, multi-size favicon.ico, and a 180x180 apple-touch-icon on a cream
background. Outputs committed for a reproducible build.

Also ship docs/MANUAL_TESTING.md with per-route / responsive / a11y / static-
asset checklists, and mark Phase 1 complete in docs/ROADMAP.md.
2026-04-21 15:21:21 -05:00
..

Documentation Folder

This folder contains business planning, architecture decisions, and documentation.

No application code belongs here.

Contents

Document Purpose
ROADMAP.md Phased build plan, data model (dataclasses), SQL schema, visual design, env-var contract
code_guidelines.md Generic Python coding standards (FastAPI overrides its Flask default for this project)
security.md Python security baseline (OWASP-aligned)
MANUAL_TESTING.md (added in Phase 1) Manual test checklist for the public site + admin
Document Purpose
../CLAUDE.md Project instructions — stack, topology, security must-haves, git flow

Guidelines

  • Keep documents focused and concise.
  • Update docs when architecture decisions change.
  • Use markdown tables for structured information.
  • Link to external documentation where relevant.