\n```\n\n`/orbiter/media/[id]` is an injected server route. It serves the file from whatever backend is configured:\n- **blob** — reads BLOB from `_media.data` and streams it\n- **local** — reads from disk at the stored path\n- **github / external link** — issues a `302` redirect to the CDN or original URL\n\nNo change needed in your templates regardless of backend.\n\n---\n\n## Multilingual\n\nOrbiter uses a `slug--locale` convention: `my-post--de`, `my-post--fr`.\n\n```astro\n---\nimport { getLocaleCollection, getLocaleEntry, locales } from 'orbiter:collections';\n\n// All German posts\nconst posts = await getLocaleCollection('posts', 'de');\n\n// German variant, falls back to base entry if not found\nconst post = await getLocaleEntry('posts', 'my-post', 'de');\n---\n```\n\nStatic paths for multilingual sites:\n\n```astro\nexport async function getStaticPaths() {\n const posts = await getCollection('posts');\n const base = posts.filter(p => !p.slug.includes('--'));\n return base.flatMap(post =>\n locales.map(loc => ({ params: { slug: post.slug, lang: loc } }))\n );\n}\n```\n\n---\n\n## Relation fields\n\nRelation fields are resolved at build time — UUID references are replaced with full Entry objects:\n\n```astro\n{posts.map(post => (\n \n
\n))}\n```\n\n---\n\n## JSON API\n\nA read-only public API is injected at `/orbiter/api/[collection]`:\n\n```bash\ncurl https://your-site.com/orbiter/api/posts\n# or with a token configured in Settings:\ncurl -H \"Authorization: Bearer your-token\" https://your-site.com/orbiter/api/posts\n```\n\nReturns all published entries as a JSON array.\n\n---\n\n## Injected routes\n\nThe integration adds these routes to your Astro site (nothing added to `src/pages`):\n\n| Route | Description |\n|-------|-------------|\n| `/orbiter/media/[id]` | Serve media (BLOB, disk, or CDN redirect) |\n| `/orbiter/api/[collection]` | Read-only JSON API |\n\nThe full admin UI lives in [`@a83/orbiter-admin`](https://www.npmjs.com/package/@a83/orbiter-admin) — a separate Hono server on port 4322.\n\n---\n\n## npm audit / esbuild warning\n\nRunning `npm audit` in an Astro 6 project may report a high-severity warning in the `astro → vite → esbuild` chain. This is a **false positive** — the advisory targets esbuild's local dev server, which Orbiter never exposes publicly.\n\nDo **not** run `npm audit fix --force` — npm may downgrade Astro to 2.x to \"fix\" it, which breaks peer dependency requirements.\n\nThe safe fix is to add `overrides` to your project's `package.json`:\n\n```json\n{\n \"overrides\": {\n \"esbuild\": \"^0.28.1\"\n }\n}\n```\n\nThen re-run `npm install`. `npm audit` will be clean without touching Astro or Vite.\n\n---\n\n## Deployment\n\nOrbiter uses `better-sqlite3` — a native Node.js module that needs **real filesystem access**. It does not run on edge runtimes or Cloudflare Workers.\n\n| Environment | Works? | Notes |\n|-------------|--------|-------|\n| Node.js VPS / Docker | ✅ | Recommended |\n| Railway / Render / Fly.io | ✅ | Mount `.pod` as a persistent volume |\n| Netlify / Vercel | ⚠️ | Read-only after deploy — run admin separately |\n| Cloudflare Workers | ❌ | No native Node.js support |\n\n---\n\n## Part of Orbiter\n\n| Package | Description |\n|---------|-------------|\n| [`@a83/orbiter-core`](https://www.npmjs.com/package/@a83/orbiter-core) | SQLite engine, pod management, auth |\n| [`@a83/orbiter-admin`](https://www.npmjs.com/package/@a83/orbiter-admin) | Standalone admin server (Hono, port 4322) |\n| [`@a83/orbiter-integration`](https://www.npmjs.com/package/@a83/orbiter-integration) | **This package** — Astro integration |\n| [`@a83/orbiter-cli`](https://www.npmjs.com/package/@a83/orbiter-cli) | `orbiter init`, `add-user`, `export`, `pack`, `unpack` |\n\n**[orbiter.sh](https://orbiter.sh)** · MIT · [github.com/aeon022/orbiter](https://github.com/aeon022/orbiter)\n","readmeFilename":"README.md"}{post.data.title}
\nby {post.data.author?.data?.name}
\n {post.data.categories?.map(cat => {cat.data.name})}\n