(Still in Development — your support is appreciated!)

This SveltyCMS headless CMS provides a powerful backend based on a modern SvelteKit 2 / Svelte 5 framework. Being designed to be database agnostic, we currently launch with MongoDB; SQL/Postgres support via Drizzle ORM is planned.

You can define Content Collections in two ways: in code or via the GUI-based collection builder. Full TypeScript support and a rich widget library make it straightforward to build custom data structures.

All widget fields support localization, validation using Valibot, and access control.

System localization uses Inlang Paraglide JS, a lightweight, type-safe i18n library. English is the default; additional languages are bundled and can be extended.

We used tailwindcss and a skeleton UI toolkit, so the CMS can be quickly optimized to your personal needs.

Backend data is available via REST API or GraphQL Yoga for fast, flexible frontends.

Get up and running fast:

1. Clone and install

git clone https://github.com/SveltyCMS/SveltyCMS.git
cd SveltyCMS
bun install  # or npm/pnpm

2. Start dev server (guided installer auto-launches)

bun run dev  # or npm run dev / pnpm run dev

3. Open the app

• Admin: http://localhost:5173/admin
• API: http://localhost:5173/api
• GraphQL: http://localhost:5173/api/graphql

Prefer a full walkthrough? See: ./docs/getting-started.mdx

• CLI installer auto-launches for smooth first-run setup
• Typed widgets and schema-driven collection builder
• Fast feedback loop with hot reloads and strong typing

To clone our repository you need to be able to use Git.

git clone https://github.com/SveltyCMS/SveltyCMS.git
cd SveltyCMS

Install STABLE Node.js to get started. Then choose your preferred package manager:

# Install all dependencies
npm install

# Development (CLI installer launches automatically if needed)
npm run dev

# Manual CLI Installer (optional)
npm run installer

# Build for production
npm run build

# Preview production build
npm run preview

# Install pnpm if you haven't already
npm install -g pnpm

# Install all dependencies
pnpm install

# Development (CLI installer launches automatically if needed)
pnpm run dev

# Manual CLI Installer (optional)
pnpm run installer

# Build for production
pnpm run build

# Preview production build
pnpm run preview

# Install bun if you haven't already
curl -fsSL https://bun.sh/install | bash

# Install all dependencies
bun install

# Development (CLI installer launches automatically if needed)
bun run dev

# Manual CLI Installer (optional)
bun run installer

# Build for production
bun run build

# Preview production build
bun run preview

When starting the dev server without configuration, the guided installer launches automatically:

• Smart detection via vite.config.ts
• Database configuration: MongoDB (SQL/Postgres planned via Drizzle ORM)
• Admin account setup, secrets/keys generation
• Optional SMTP and Google OAuth configuration

Start with:

bun run dev  # or npm run dev / pnpm run dev

See our package.json for more information about development, build, preview, format, lint & testing commands.

• Development server runs on localhost:5173
• Preview server runs on localhost:4173

We want to keep your data Private and Secure.

Our extensive Authentication allows us to stay flexible for the future and adapt to changing security needs.

You can log in with email/password or Google OAuth. Role- and field-based access control lets you define precisely who can view, edit, or delete content. Sensitive data is masked in logs; admin-only endpoints protect operational features.

If you require a different look, use the skeleton theme generator and modify the SveltyCMSTheme.ts to your needs

Great Experience to designing user-friendly and intuitive interfaces for managing content. Full Typescript support to display all available widgets, options to create fully custom data structures.

Build and send emails using Svelty Email and TypeScript.

SveltyCMS is built with modern optimization techniques resulting in a compact bundle compared to traditional CMS platforms:

What this means:

• ✅ Smaller downloads = Faster initial load
• ✅ Lower bandwidth costs = Savings at scale
• ✅ Better mobile experience = Works well on slower connections
• ✅ Brotli compression = Automatically served by modern servers

Comprehensive documentation is available to help you get started:

• 📖 Documentation — Guides, API reference, and architecture
• 🎯 Getting Started — Quick start guide
• 🏗️ Architecture: Database Resilience — ./docs/architecture/database-resilience.mdx
• 🤝 Contributing Guide — How to contribute

REST (fetch 5 posts):

curl -H "Authorization: Bearer <token>" \
  "http://localhost:5173/api/collections/posts?limit=5"

GraphQL (posts with author):

query {
	posts(limit: 5) {
		id
		title
		slug
		author {
			name
		}
	}
}

SveltyCMS is licensed under the Business Source License 1.1 (BSL 1.1) — Fair Source software that balances openness with sustainability.

• ✅ Free for individuals & small businesses — Use, modify, and deploy in production if your organization's total finances are under $1,000,000 USD
• 💼 Paid license for larger organizations — Commercial license required if total finances exceed $1M USD
• 🔓 Future open source — Automatically converts to MIT License on the "Change Date" specified in the license file
• 🤝 Open collaboration — Source code is publicly available; contributions welcome

If your organization's Total Finances (revenue, funding, assets) exceed $1,000,000 USD, you must purchase a commercial license to use SveltyCMS in production.

📧 Email: info@sveltycms.com

For more details, see the full LICENSE file.

Contact us if you're struggling with installation or other issues:

• 💬 GitHub Discussions
• 💬 Discord Server
• 🔧 Report Issues
• 📖 Documentation
• 📧 Email: support@sveltycms.com

For detailed information on our Git workflow, branching strategy, and commit conventions, see our Git Workflow & Automated Releases guide.

We use semantic versioning to manage our releases. This means that our version numbers follow a specific format: MAJOR.MINOR.PATCH.

• MAJOR version changes when we make incompatible API changes
• MINOR version changes when we add functionality in a backwards-compatible manner
• PATCH version changes when we make backwards-compatible bug fixes

When submitting pull requests, please make sure your commit messages follow the Conventional Commits specification. This will help us automatically generate changelogs and release notes.

Please also read our Code of Conduct before submitting Pull Requests.

If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running pnpm changeset and following the prompts. Changesets that add features should be minor and those that fix bugs should be patch.

Run the tests with pnpm test and lint the project with pnpm lint and pnpm check.

Please prefix changeset messages with feat:, fix:, or chore:.

Thank you for helping us maintain a consistent and predictable release process! ❤️

We welcome all kinds of contributions! Please see our CONTRIBUTING.md for details on how to get started.

If you find our project useful and would like to support its development, you can become a sponsor! Your sponsorship will help us cover the costs of maintaining the project and allow us to dedicate more time to its development.

There are several ways you can sponsor us:

• Become a GitHub sponsor
• Donate via PayPal

Thank you for your support! 🙏

To all our contributors — without you, SveltyCMS would never have been possible.

If you like what we're doing, give us a star and share our SveltyCMS project with others!