example workflow codecov

Super Simple Static Site (ssss)

ssss is a static site generator that uses Jinja2 and Markdown to build fast, lightweight static HTML sites. Scaffold a new site in seconds and run it anywhere.

Installation

Using uv / uvx (Recommended)

Run ssss instantly without manual installation via uvx:

uvx ssss --scaffold

Or install ssss globally as a tool using uv:

uv tool install ssss

Using pipx

Install ssss in an isolated environment via pipx:

pipx install ssss

On Arch Linux, install pipx first if needed:

sudo pacman -S python-pipx

Using pip

Alternatively, if you are in an active virtual environment:

pip install ssss

Usage

Quick start

Run --scaffold to initialize a new project, write starter templates and content, and build the site in one step:

ssss --scaffold

This creates:

ssss.yml                          # configuration file
site/
  source/
    index.md                      # starter content
    _templates/
      base.html                   # HTML base layout (Pico CSS included)
      default.j2                  # default Jinja2 template
  build/
    index.html                    # generated output

Init only

Use --init if you only want to create the configuration file and directory structure, without writing any template or content files:

ssss --init

Build an existing site

Once a configuration file exists, run ssss without any flags to build:

ssss

Use a custom config file

ssss --config path/to/custom.yml

Configuration

Configure your site via ssss.yml. The site section defines site-wide variables accessible in all templates and content files:

site:
  title: My Site
  description: A site built with ssss.
  author: Your Name
  url: https://example.com

Templates

Templates live in site/source/_templates/. ssss uses staticjinja for rendering.

  • base.html — base HTML layout, extended by Jinja2 templates
  • default.j2 — default template, applied to all Markdown files without a dedicated template
  • __<stem>.j2 — template applied only to the content file with the matching stem

The default scaffold includes Pico CSS via CDN — a minimal, classless CSS framework for semantic HTML that makes every page look clean with zero extra effort.

CLI reference

ssss --help
Flag Description
--scaffold Create config, directories, and starter files, then build
--init Create config and directories only
--config, -c Path to a configuration file
--version, -v Print the version and exit
--help, -h Show help and exit

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.3.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for MangeBang from gravatar.com MangeBang

Credits

Author: Magnus Åberg

Requires

Python <4.0, >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ssss-1.3.0.tar.gz (11.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ssss-1.3.0-py3-none-any.whl (16.2 kB view details)

Uploaded Python 3

File details

Details for the file ssss-1.3.0.tar.gz.

File metadata

  • Download URL: ssss-1.3.0.tar.gz
  • Upload date:
  • Size: 11.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ssss-1.3.0.tar.gz
Algorithm Hash digest
SHA256 8b1b1131cd172b7dfc8541e1a14bc2a9bc444205ec55b8e98abe509e3a58c9a3
MD5 a2e6546204ec35b58ec449e9a52546d3
BLAKE2b-256 39804377f4367b501ead63dc7c3288b69dfe6daa2490ecba5cdd03b973bc0da9

See more details on using hashes here.

Provenance

The following attestation bundles were made for ssss-1.3.0.tar.gz:

Publisher: publish.yml on the-commits/super-simple-static-site

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ssss-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: ssss-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 16.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ssss-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 749591e236c8e4379e6f8764e7853f13ae0532457fba1bef480a73b8e4805d42
MD5 7a9d114e9e6bb451e737217a21c20a75
BLAKE2b-256 aab8558c72d53c9e042ad362aefb064103f52fcf4b9faa2a010c19b944a06529

See more details on using hashes here.

Provenance

The following attestation bundles were made for ssss-1.3.0-py3-none-any.whl:

Publisher: publish.yml on the-commits/super-simple-static-site

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page