Skip to content

docs: MDX content collection + public sync API, resynced with main (continues #4) #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
barckcode merged 13 commits into from
Jul 14, 2026
Merged

docs: MDX content collection + public sync API, resynced with main (continues #4) #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
ef12f9f
feat(docs): migrate docs site to MDX content collection with public API
Saul-Gomez-J May 25, 2026
94edc80
Merge remote-tracking branch 'origin/main' into feat/docs-content-col…
Nxssie May 25, 2026
cfe8acc
docs: use bash fences for curl examples
Nxssie May 25, 2026
8931b4d
docs(examples): restore curl headings for request-method sections
Nxssie May 25, 2026
c180c40
feat(docs): canonical MDX→text pipeline + ETag/304 on docs API
Saul-Gomez-J May 26, 2026
8f7c344
fix(ci): satisfy astro check under strict mode
Saul-Gomez-J May 26, 2026
3e3b88c
merge: sync docs content collection with main
santigamo Jul 9, 2026
5fd334e
fix(docs): fail-fast on MDX expressions the text extractor cannot eva…
santigamo Jul 9, 2026
5dbafec
feat(docs): single source of truth for rate limits
santigamo Jul 9, 2026
8ce89a8
test(docs): pin the canonical text against the bot's canonicaliser
santigamo Jul 9, 2026
26a71eb
docs: resync the content collection with main
santigamo Jul 9, 2026
e0c2eec
fix(docs): close the findings from the sign-off review
santigamo Jul 9, 2026
278db7a
fix(docs): controlled 500s and a fail-fast manifest in the docs API
santigamo Jul 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,11 @@ CLOUD_API_WAITLIST_KEY=
# is missing, /api/waitlist still succeeds but skips the confirmation email.
RESEND_API_KEY=
RESEND_FROM_EMAIL=no-reply@nan.builders

# Per-key rate limits shown in the docs and served to the Discord bot.
# Not secrets: the deployed values live in wrangler.jsonc under `vars`, and
# src/lib/rateLimits.ts falls back to the same numbers when they are missing.
# Override here only to see a different value in `astro dev`. Changing them
# changes the docs contentHash, so the bot re-syncs on its next manifest poll.
RATE_LIMIT_RPM=60
RATE_LIMIT_PARALLEL=5
3 changes: 2 additions & 1 deletion astro.config.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
import { defineConfig } from 'astro/config';

import cloudflare from '@astrojs/cloudflare';
import mdx from '@astrojs/mdx';
import preact from '@astrojs/preact';
import tailwindcss from '@tailwindcss/vite';
import rehypePrettyCode from 'rehype-pretty-code';
Expand All @@ -10,7 +11,7 @@ import rehypePrettyCode from 'rehype-pretty-code';
export default defineConfig({
output: 'server',
adapter: cloudflare(),
integrations: [preact()],
integrations: [preact(), mdx()],

// We do not use Astro sessions in v1 (no auth). The Cloudflare adapter
// otherwise auto-enables a KV-backed session driver and tries to inject a
Expand Down
Loading