LightCMS Git Based CMS for Static Sites
LightCMS the Git based CMS for static sites. Write and publish Markdown with front matter using Zola, Hugo, Astro, or Jekyll; every edit is a commit
LightCMS Is an easy to use, interactive, Git based CMS built to help you discover the hidden writer in you and fall in love with writing again.
Compatible with any static site generator (SSG) that supports front matter schema Zola, Hugo, Astro, Jekyll, Eleventy, Next.js, Nuxt, and more. LightCMS Makes creating, managing, and publishing content effortless.
Whether you’re sharing experiences, documenting your journey, or putting thoughts into words, LightCMS turns ideas into published pages without the friction.
Why LightCMS?
| Problem | LightCMS Approach |
|---|---|
| CMS for you | Your content lives in your Git repo as markdown files which can be edited by any text editor |
| No local preview | The built‑in WYSIWYG editor displays your content exactly as it will appear. |
| Independent hosting | Deploy anywhere: Netlify, Vercel, Cloudflare Pages, GitHub Pages, your own server, s3 bucket |
| Not stuck in DB | Every edit is a Git commit — full history, diffs, rollback |
Core Features
Git Native Content Storage
- Content = Markdown files + front matter schema
- Every save = Git commit (signed, if you configure it)
- Branches = drafts, PRs = editorial workflow
- No database, no vendor lock-in
Visual Editor with Live Preview
- Block-based editor (headings, paragraphs, code, images, tables, callouts)
- Real-time preview using your SSG’s templates and CSS
- Dark/light mode matches your site
AI Writing Assistant (optional)
- Inline completions, rephrasing, summarization
- Runs via OpenAI compatible API (OpenAI, openrouter)
- Your content never leaves your infrastructure unless you choose
Speech to Text
- Dictate drafts directly in the editor
- Powered by Whisper compatible API or cloud APIs
- Useful for capturing thoughts faster than typing
Multiple SSG Support (Static Site Generator Neutral)
LightCMS is designed with the vision of remaining independent of any specific static site generator, providing a configuration free experience.
Getting Started
1. Try the hosted demo
https://www.lightcms.me/ — connect a test repo and start writing.
2. Self-host (recommended for teams)
# Clone
git clone https://github.com/light-cms/lightcms
cd lightcms
## configure it properly
bun run build
bun run deploy3. zero configuration by default
No configuration file required you can use it as is out of the box with all the features.
Architecture
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ LightCMS UI │────▶│ GitHub/GitLab │────▶│ Your SSG Repo │
│ (React + Vite) │ │ OAuth + API │ │ (Markdown + FM) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ Preview Worker │ │ Deploy Hook │
│ (runs your SSG)│ │ (Netlify/Vercel)│
└─────────────────┘ └─────────────────┘- Frontend: Sveltekit, TypeScript, Vite, Tailwind
- Auth: GitHub/GitLab OAuth using better auth
Use Cases
Technical Blog / Documentation
- Write posts in a clean editor
- Preview renders your actual Zola/Hugo/Astro theme
- Publish → Git commit → auto-deploy
Product Changelog
- Team writes entries in LightCMS
- Changelog page pulls from
content/changelog/*.md - Version tags autogenerated from front matter
Knowledge Base / Wiki
- Hierarchical collections (
docs/getting-started/,docs/api/) - Cross-references via front matter
linksfield - Search via Pagefind/Algolia on generated site
Newsletter (à la utterances)
- Write issues in LightCMS
- GitHub Action compiles to email via your template
- Sent via Resend/SendGrid/Postmark
Pricing
Free only
Every edition is fully featured no artificial limits.
Links
- 🌐 Live demo: https://www.lightcms.me/
- 📦 GitHub: https://github.com/light-cms/lightcms
- 📖 Docs: https://lightcms.me/docs
- 💬 Discord: https://discord.gg/sm4S8src7V
- 🐛 Issues: https://github.com/light-cms/lightcms/issues
- 📜 License: Apache 2.0
LightCMS is built by developers who got tired of fighting CMSs. If it helps you write, star the repo.
Comments