@devries-cameron20 / t3code Mirror · read-only
Fork 0

The best way to control Claude Code, Codex and more from any computer or phone

Mirrored from https://github.com/Camo67/t3code.git

Synced Nov 21, 06:00 UTC

main
md 43 lines 1.39 KB
Rendered Raw
1 # Alchemy Effect Website
2
3 This workspace contains the customer-facing docs site for Alchemy Effect.
4
5 ## Build Pipeline
6
7 The site is intentionally split into independent steps:
8
9 1. `pnpm build:reference` generates Zola-compatible API reference pages from the TypeScript source tree.
10 2. `pnpm build:assets` compiles the shared Tailwind CSS and the custom browser JavaScript bundle.
11 3. `pnpm build:site` renders the site with Zola.
12 4. `pnpm build:search` indexes the built HTML with Pagefind.
13 5. `alchemy.run.ts` deploys the final `dist/` directory through `Cloudflare.Website.StaticSite(...)`.
14
15 This keeps the large markdown corpus on a Rust-first rendering path while still
16 allowing a modern custom UI.
17
18 ## Local Commands
19
20 - `pnpm build`
21 - `pnpm dev:site`
22 - `pnpm deploy`
23 - `pnpm destroy`
24
25 The dev server makes copy editable in the browser on the home page only. Set
26 `ALCHEMY_DOCS_EDIT=1` when launching it (e.g. `ALCHEMY_DOCS_EDIT=1 pnpm dev:site`)
27 to also edit docs and reference pages in place.
28
29 ## Benchmark Snapshot
30
31 Measured locally on 2026-04-02:
32
33 - API reference generation: about `2.2s`
34 - Tailwind + browser bundle build: about `0.9s`
35 - Zola render: about `0.6s`
36 - Pagefind indexing: about `0.3s`
37 - Total built files in `dist/`: `693`
38 - Total built bytes in `dist/`: `3,120,670`
39 - Pagefind files: `350`
40 - Pagefind bytes: `633,383`
41
42 These numbers should be treated as a baseline for future changes to the docs
43 pipeline.