# Goodwalk docs

Reference, audit, and planning documents for the Goodwalk site. Project-level rules live in [`/CLAUDE.md`](../CLAUDE.md); everything else lives here.

## Product & brand

- [product.md](product.md) — users, purpose, brand personality, design principles
- [marketing-principles.md](marketing-principles.md) — Chris Do / Debbie Millman principles, applied to the rebuild
- [marketing-voice.md](marketing-voice.md) — copy/voice style guide (calm, certain, warm, specific)

## Design

- [design-language.md](design-language.md) — canonical visual system: colour, typography, spacing, motion, surface, photography direction
- [design-audit.md](design-audit.md) — codebase-wide design drift audit + token/refactor changelog
- [homepage-flow-audit.md](homepage-flow-audit.md) — section-by-section IA review of the homepage
- [mobile-polish.md](mobile-polish.md) — mobile conversion & comfort tracker
- [ux-polish.md](ux-polish.md) — conversion audit tracker

## SEO & growth

- [competitors.md](competitors.md) — Fetch / Sticks & Bones analysis + what to borrow
- [comparison-page-plan.md](comparison-page-plan.md) — brief for the dog-walker-vs-daycare-vs-sitter page
- [nz-citations.md](nz-citations.md) — canonical NAP block + directory submission list

## Ops

- [deployment.md](deployment.md) — production deploy flow, server layout, nginx cutover
- [webp-conversion.md](webp-conversion.md) — one-time WebP setup for hero images
- [onboarding.md](onboarding.md) — client onboarding flow, lifecycle status, legacy CSV migration, Postgres target schema

## Archive

- [archive/v3-design-audit.md](archive/v3-design-audit.md) — superseded by [design-audit.md](design-audit.md)
- [archive/marketing-voice-v2-proposal.md](archive/marketing-voice-v2-proposal.md) — one-shot copy-change proposal against [marketing-voice.md](marketing-voice.md)