The Foundation
SvelteKit Native
No adapters or bridges. Developers who know SvelteKit already know Cosmolo. Built directly on MDSveX and adapter-static.
Type-Safe Content
Frontmatter is validated with Zod at build time. Malformed articles fail loudly during build, ensuring your site is always robust.
Config over Convention
Site identity and taxonomy are JSON files. No source code changes are needed to add categories or update site metadata.
Why Cosmolo?
While Astro is a brilliant framework for many use cases, SvelteKit developers often reach for it not because they prefer its concepts, but because SvelteKit lacked a canonical "just add Markdown and go" story.
Cosmolo is that story. It occupies the same content-site niche as Astro but stays entirely within the SvelteKit ecosystem. It provides a deliberate, scholarly approach to static site generation, ensuring that developers who know SvelteKit can remain in their element.
"A deliberate nod to Astro, staying entirely within the SvelteKit ecosystem."
Comparison
| Feature | Cosmolo | Astro | Nuxt Content |
|---|---|---|---|
| Framework | SvelteKit | Astro | Nuxt (Vue) |
| Markdown | MDSveX | Built-in | Built-in |
| Type-safe | Zod | TS inference | Zod (opt) |
| Categories | Config-driven | No | No |
| Curve | SvelteKit only | Astro concepts | Vue + Nuxt |
How It Works
Cosmolo's architecture is built on the principles of logic and clarity. By utilizing a config-driven approach and SvelteKit's native strengths, we provide a production-ready environment that prioritizes type-safety and developer experience. Explore the blueprints below.
Architectural Configuration
Centralize your site's identity. Cosmolo uses a strictly typed JSON configuration for global metadata, SEO defaults, and OGP generation settings. This approach ensures your site remains consistent across all pages without deep-diving into the source code for every minor update.
- Zod-validated site metadata
- Automatic OGP image generation modes
- Configurable global SEO parameters
// config/site.json
{
"name": "Cosmolo",
"description": "A SvelteKit-native Markdown CMS",
"ogImage": { "mode": "generated" }
}Taxonomy & Organization
Manage your content's hierarchy through a simple registry. Define categories with meaningful labels and descriptions that automatically generate dedicated landing pages and navigation links. Our "fallback" system ensures that even unsorted articles find a home.
- Dynamic category routing
- Automatic "Other" category fallback
- Description-driven category headers
// config/categories.json
{
"tech": {
"label": "Technology",
"description": "Articles about software and tools."
},
"design": {
"label": "Design",
"description": "Articles about UI/UX design."
}
}Expressive Authorship
Write in standard Markdown or leverage the power of Svelte components with MDSveX. Every article is a masterpiece of logic, featuring Zod-validated frontmatter and automatic slugs. Whether it's a simple thought or a complex interactive guide, Cosmolo scales with your creativity.
- MDSveX (.svx) for interactive content
- Type-safe frontmatter validation
- YouTube and Custom Component support
---
title: "My Scholarly Article"
category: "tech"
excerpt: "A deep dive into cosmic web structures."
sort: 100
date: "2025-01-15"
---
# Introduction
Cosmolo supports standard Markdown and **Svelte components** via MDSveX.
<Callout type="tip">
This is a Svelte component inside Markdown!
</Callout>