Skip to content
Public template

About

Open-source Astro Starlight documentation template with sitemap and llms.txt out of the box.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Potluck Docs

Potluck Docs is an open-source Astro + Starlight documentation template — interactive OpenAPI references, private docs behind your SSO, and llms.txt built in. Maintained by EkLine.

This repository is the monorepo that holds it, alongside the sites EkLine hosts on top of it.

Are you here to build a docs site?

Then you want the template, not this repository:

npm create astro@latest -- --template ekline-io/potluck-docs/packages/template --no-ai

That fetches packages/template/ — the whole product, lockfile included — and leaves you a plain directory to make your own. Its README takes it from there.

Not the "Use this template" button. The template is a subdirectory here, and the button copies whole repositories, so it would hand you the build tooling and EkLine's own sites along with it.

Live preview: https://potluck-demo.ekline.io/ — with the demo login enabled, so you can sign in as a fake reader and see the private and per-org docs work.

Documentation: https://potluck.ekline.io — every setting in the template, what it does, and what happens if you leave it alone.

What is in here

Path What it is
packages/template/ The template EkLine ships. Self-contained: its own package.json, its own committed lockfile, its own CLAUDE.md. This is what the command above copies.
apps/docs/ The hosted documentation for the template — how to configure it, what every setting does. Built with the template itself. Live at https://potluck.ekline.io.
docs/superpowers/ Design specs and implementation plans. Development history; never part of what a customer receives.

Working in this repo

Each project is independent — there is no npm workspace and no hoisted node_modules. The root package.json only delegates:

npm run check   # type-check the template
npm test        # build it and run the test suite

Anything more specific runs from the project itself:

cd packages/template && npm ci && npm run dev

The missing workspaces key is deliberate — please do not add it. The template is delivered as a directory copy, so it has to carry its own package-lock.json; under workspaces that file would live at the root and no customer would ever receive it. An unlocked install is not a theoretical problem here — it resolves an Astro/Vite combination that breaks @tailwindcss/vite. The reasoning is in CLAUDE.md.

License

MIT.

About

Open-source Astro Starlight documentation template with sitemap and llms.txt out of the box.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages