Documentation Hub

Disponible en francais

Use this folder as the working map of the Fenod stack. The root README.md explains the baseline; these guides explain how to build, test, ship, and improve with it.

Recommended Reading Paths

Starting a new project

1. Stack Overview
2. Tooling
3. Migration Guide
4. Development Strategy
5. Code Patterns
6. React Best Practices

Building with AI

1. AI Development Workflow
2. Security Model
3. MCP Guide
4. TDD with AI
5. Testing Guide
6. Debugging

Shipping to production

1. Deployment Guide
2. Environment and Secrets
3. Cloudflare API Tokens
4. Security Model
5. Email
6. App Improvement Guide
7. Debugging
8. Local Toolchain Snapshot

Content and product surfaces

1. Astro SEO Guide
2. TanStack Data Fetching
3. Offline-First Guide

Guides by Topic

Foundations

Guide	Use it for
Stack Overview	Choosing the primary defaults and avoiding stack sprawl
Tooling	VoidZero, Vite, Vitest, Ultracite, tsgo, Rolldown, and tsdown defaults
Migration Guide	Going from scaffold to production-ready project
Development Strategy	Phased delivery and UI-first execution
Code Patterns	Reusable implementation patterns across the stack
React Best Practices	Simple React rules for agents, PRs, security, accessibility, and React Doctor

AI and Workflow

Guide	Use it for
AI Development Workflow	Daily collaboration model with Cursor, Claude Code, MCP, and verification
Security Model	Secrets, agents, Cloudflare authority, prompt injection, data, and production gates
AI Providers	Workers AI, AI Gateway, Replicate — model guide and provider comparison
MCP Guide	Dynamic tool loading, browser inspection, and Cloudflare tooling
TDD with AI	Making AI output safer with red/green/refactor loops
Testing Guide	Vitest, Playwright, MSW, React Doctor, and test structure
Debugging	Console, browser, and edge debugging workflows

Shipping and Hardening

Guide	Use it for
Deployment Guide	Cloudflare deployment, CI/CD, and runtime bindings
Environment and Secrets	Infisical, Cloudflare secrets, and safe deploy-time environment handling
Cloudflare API Tokens	Least-privilege API tokens, AI-agent guardrails, and secure Wrangler usage
Security Model	Cross-cutting security model for secrets, agents, data, and production changes
Email	Cloudflare inbound email, transactional outbound, deliverability, and agent-safe workflows
App Improvement Guide	Performance, resilience, and operational hardening
Local Toolchain Snapshot	Auditing what is installed locally and what should stay primary
Cloudflare Compute	Worker vs Dynamic Worker vs Container: when to use each

Frontend and Product Surfaces

Guide	Use it for
TanStack Data Fetching	Choosing between loaders, queries, and hybrid patterns
Astro SEO Guide	Structured SEO work for content-heavy projects
Rybbit Analytics	First-party Rybbit proxy on Cloudflare Workers / Pages
Offline-First Guide	PWA, IndexedDB, sync, and resilience patterns

Notes

• French translations live in fr.
• Machine-specific details belong in Local Toolchain Snapshot, not in the root README.md.
• Reusable development practices belong in docs; one-off project quirks should stay inside the project itself.