Quick Start

Get a SuCoS site running in under two minutes.

1. Install

Download the binary for your platform from the releases page and add it to your PATH.

Verify:

sucos --version

2. Create a site

sucos new-site ./my-site
cd my-site

This creates:

my-site/
├── content/
├── static/
├── themes/
└── sucos.yaml

3. Add a theme

Without a theme, SuCoS renders bare unstyled HTML. Scaffold a minimal one:

sucos new-theme

Then set it in sucos.yaml:

Theme: my-theme

4. Write your first post

Create content/blog/hello-world.md:

---
Title: Hello, World!
Date: 2026-04-24
---

This is my first post on SuCoS.

5. Preview

sucos serve

Open http://localhost:2341. Edit any file and the browser refreshes automatically.

6. Build for production

sucos build

The complete site is written to public/. Upload that directory to any static host.

What's next?

Quick Start