Skip to content

Commit a60991d

Browse files
committed
docs: Update CLAUDE.md with correct VPS deployment info
- Replace Cloudflare Pages with VPS (Docker) deployment - Update tech stack from VitePress to Astro Starlight - Add OG image generation documentation - Update SSH host and port info
1 parent a46d611 commit a60991d

File tree

1 file changed

+38
-19
lines changed

1 file changed

+38
-19
lines changed

CLAUDE.md

Lines changed: 38 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,15 @@
88

99
```
1010
docs-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
2427
npm 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

Comments
 (0)