openlakeforge.dev
The public website of OpenLakeForge:
a presentation page and the documentation, served at
https://openlakeforge.dev.
Built with Astro and Starlight in the OpenLakeForge Deep Water design
system (Figma). The
documentation is synced at build time from the openlakeforge repository at
the ref in docs.lock (the latest release tag) by scripts/sync-docs.mjs,
which runs before dev and build. A new release bumps docs.lock and the
announcement bar (release in src/data/landing.ts) together.
Develop
Requires Node.js 22 or later.
npm install
npm run dev # http://localhost:4321
npm run build # static site in dist/
npm run preview # serve dist/
/ is the presentation page (src/pages/index.astro, copy in src/data/landing.ts)./style-guide/ shows every documentation element in the theme./llms.txt, /llms-full.txt, /llms-small.txt and /<docs page>.md serve the
synced docs as Markdown for AI agents (src/lib/llms.ts).
Contribute and deploy
main is production: merging a pull request into main deploys
openlakeforge.dev. The site is hosted on Cloudflare, configured in
wrangler.jsonc, and built by Cloudflare Workers Builds,
which is connected to this repository (no token lives in GitHub).
| Branch | What Cloudflare does |
|---|
main | npm run build then npx wrangler deploy → https://openlakeforge.dev |
| any other branch | npm run build then npx wrangler preview → a Preview per branch, linked on the PR |
main is protected: changes land only through pull requests, the
CI build must pass, and the code owner
(CODEOWNERS) approves.
Status: the presentation page and the docs sync are built. The docs come
from the openlakeforge v0.5.0-alpha.1 tag (docs.lock). See
PLAN.md.
