@geekity/cms
A file-first CMS. Content is Markdown on disk, in a layout that Eleventy can build unchanged. One Node process serves both the editor and the public website. SQLite holds a derived index plus the data that has no natural file form.
Requires Node 26 or newer, the active LTS line.
A new site
pnpm dlx @geekity/cms init my-site
cd my-site
pnpm install
pnpm dev
The site runs on http://localhost:3000 with a post, an About page, a
starter privacy page and the packaged theme. geekity init refuses a directory
that is not empty, so it never overwrites an existing site.
An existing project
pnpm add @geekity/cms
Then write a geekity.config.ts and a content/ directory, and either add an
entry file or run geekity serve.
Upgrading
pnpm up @geekity/cms
Database migrations ship inside the package and run on boot. To upgrade, bump the version. Upgrading lists what semver covers.
Documentation
The guides live in the repository's
docs/ folder:
- Getting started
- The
geekitycommand - Configuration
- Content
- The admin
- The public site
- Federation
- Feeds
- Plugins and hooks
- Themes
- Deploying
- Building the same content with Eleventy
License
MIT