Anatomy of a project

my-site/
├── astro.config.mjs           ★ integration, languages, static output
├── package.json               ★ site scripts
├── wrangler.toml                function configuration for the host
├── tsconfig.json
├── .env.example                 variable template — the only versioned one
├── .dev.vars                    local variables — ignored by Git
├── .gitignore
│
├── functions/
│   └── api/
│       ├── auth.ts              ┐
│       ├── content.ts           │ four 5-line adapters,
│       ├── save.ts              │ never a rule
│       └── upload.ts            ┘
│
├── scripts/
│   ├── check-html.mjs           content present in raw HTML
│   ├── check-locales.mjs        key parity across languages
│   ├── check-logs.mjs           no secret in a console.*
│   ├── check-secrets.mjs        no secret in dist/
│   ├── make-key.mjs             a key and its hash — rotation
│   └── mock-git-api.mjs         fake local repository
│
├── src/
│   ├── content/
│   │   ├── config.ts            collection declaration (schema from the package)
│   │   ├── site.json          ★ navigation, contact details, footer
│   │   ├── site.ts              site.json validation at build time
│   │   └── pages/
│   │       ├── fr/home.json   ★ THE content — one page, one language, one file
│   │       └── en/home.json   ★
│   │
│   ├── components/            ★ your components — static by default
│   │   └── Testimonial.astro
│   ├── layouts/
│   │   └── Base.astro         ★ metadata, navigation, footer
│   ├── lib/
│   │   └── locales.ts         ★ the languages of THIS site
│   ├── media/                 ★ the images — in src/, not in public/
│   │   └── library.ts           created by the integration, leave as is
│   ├── pages/
│   │   └── [lang]/[...slug].astro  ★ the page template
│   └── styles/
│       └── theme.css          ★ THE theme: palette, scale, rhythm
│
└── .github/workflows/ci.yml     automated checks

inline-core/
├── astro/index.ts             the integration: /admin, /aide, overlay, bootstrap
├── components/
│   ├── Editable.astro         a text or richtext field
│   ├── Media.astro            an image or a video
│   └── Collection.astro       a list + its item template
├── pages/
│   ├── admin.astro            the key entry page
│   └── aide.astro             the client help page, ready to use
├── styles/tokens.css          one class per schema value
└── src/
    ├── schema.ts              THE content model (Zod) — build AND server
    ├── style-tokens.ts        the allowed variants, single source
    ├── safe-href.ts           what a safe link is, on both sides
    ├── video.ts               reading a YouTube / Vimeo address
    ├── translate.ts           translation fallback (not the language list)
    ├── editor/                the overlay — TypeScript, no framework
    │   ├── index.ts           the loop: a path, a pointer, a mutation
    │   ├── bar.ts             floating bar and banners
    │   ├── toolbar.ts         variants and richtext toolbars
    │   ├── media.ts           image / video panel
    │   ├── collection.ts      add, duplicate, move, delete
    │   ├── draft.ts           local draft
    │   ├── sanitize.ts        browser-side sanitising
    │   ├── heic.ts            iPhone photo decoding, on demand
    │   └── api.ts             the calls to the four routes
    └── server/
        ├── auth.ts            verifyAuth / createSession — sole judge of identity
        ├── guard.ts           rate, caps, allowed paths
        ├── rate-limit.ts      call counting, interchangeable storage
        ├── git-provider.ts    the Git provider interface
        ├── github.ts          GitHub implementation (version = blob SHA)
        ├── gitlab.ts          signature + notes — not implemented
        ├── image.ts           format recognition from the bytes
        ├── sanitize.ts        server-side sanitising (no DOM)
        └── routes/            the four routes, as configurable factories