88
99```
1010docs-lumos/
11- ├── .vitepress/config.ts # Site configuration
12- ├── index.md # Homepage
13- ├── guide/ # Getting started
14- ├── reference/ # Language reference
15- ├── examples/ # Code examples
16- └── api/ # CLI/library API
11+ ├── astro.config.mjs # Site configuration
12+ ├── src/
13+ │ ├── content/docs/ # Documentation pages (MDX)
14+ │ ├── components/ # Custom components (Head, Footer)
15+ │ └── styles/ # Custom CSS
16+ ├── public/
17+ │ └── og/ # Generated OG images
18+ └── scripts/
19+ └── generate-og-images.js # OG image generator
1720```
1821
1922---
@@ -22,31 +25,47 @@ docs-lumos/
2225
2326``` bash
2427npm install
25- npm run docs:dev # Dev server (localhost:5173)
26- npm run docs:build # Build for production
27- npm run docs:preview # Preview build
28+ npm run dev # Dev server (localhost:4321)
29+ npm run build # Build for production (generates OG images first)
30+ npm run build:og # Regenerate OG images only
31+ npm run preview # Preview build
2832```
2933
3034---
3135
3236## Deployment
3337
34- ** Platform:** Cloudflare Pages
35- ** Domain:** lumos-lang.org
36- ** Auto-deploy:** Push to ` main ` → live
38+ ** Platform:** VPS (Docker)
39+ ** SSH Host:** ` lumos ` (176.222.53.185)
40+ ** User:** ` lumos `
41+ ** Port:** 4000
42+ ** Domain:** docs.lumos-lang.org
43+ ** Auto-deploy:** GitHub Actions → Docker → VPS
3744
38- ** Build:** ` npm run docs: build ` → ` .vitepress/ dist/`
45+ ** Build:** ` npm run build ` → ` dist/ `
3946
4047---
4148
4249## Key Pages to Maintain
4350
44- - ` guide/installation.md ` - Update on version changes
45- - ` reference /types.md` - Keep type mapping table current
46- - ` examples/* ` - Add real-world patterns
47- - ` CHANGELOG.md ` - Update every release
51+ - ` src/content/docs/getting-started/ ` - Update on version changes
52+ - ` src/content/docs/api /types.md` - Keep type mapping table current
53+ - ` src/content/docs/frameworks/ ` - Framework integration guides
54+ - ` src/content/docs/guides/ ` - Add real-world patterns
4855
4956---
5057
51- ** Last Updated:** 2025-11-22
52- ** Status:** Live at https://lumos-lang.org
58+ ## OG Image Generation
59+
60+ Dynamic OG images are generated at build time using ` satori ` + ` @resvg/resvg-js ` :
61+
62+ ``` bash
63+ npm run build:og # Generate all 42 OG images
64+ ```
65+
66+ Images are saved to ` public/og/{slug}.png ` (1200x630px).
67+
68+ ---
69+
70+ ** Last Updated:** 2025-12-16
71+ ** Status:** Live at https://docs.lumos-lang.org
0 commit comments