site-com/CLAUDE.md

gazperi.com — Docusaurus project

Always-load companion when working anywhere under SITE/site-com/. Routes Claude to the right operational procedure in documentation/ per task. Project history and rationale live in spec 0211.

Project shape

• Stack: Docusaurus v3 (TypeScript), Infima theming, custom React landing.
• Hosting: Cloudflare Pages (gazperi-com project) on gazperi.com. Registrar: Hostinger; nameservers point at Cloudflare.
• Analytics: PostHog EU (https://eu.i.posthog.com).
• Git: local-only; no remote.
• Public content lives under docs/ (route /educacao/*). Internal operational procedures live under documentation/ (this folder, not part of the site build).

Routing — operational procedures

Adding a guide. Read documentation/add-guide.md.

Adding an article. Read documentation/add-article.md.

Adding a top-level section. Read documentation/add-section.md.

Adjusting brand tokens (colors, fonts). Read documentation/brand-tokens.md. Brand source of truth lives in /Users/gazperi/Developer/ATIVOS/brand/CLAUDE.md — do not invent tokens.

Running dev / build / deploy locally. Read documentation/dev-build-deploy.md.

Working with PostHog (events, env vars, rotation). Read documentation/posthog-events.md.

Updating SEO surfaces or LLM-discoverability artifacts. Read documentation/seo-and-llms.md.

Deploying to Cloudflare or doing a DNS / domain change. Read documentation/cloudflare-deploy.md.

Boundaries

• documentation/ is internal — never published to the site. Public content lives in docs/.
• Voice: published copy in docs/ and src/pages/ follows DOCS/brand-voice/ rules (PT-BR). documentation/ (internal procedures) is English by default.
• Brand tokens come from ATIVOS/brand/. Do not duplicate values here.
• No direct edits to build/ — regenerated on every build.