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

License

AGPL-3.0-or-later © Magnus Åberg (The Commits)

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

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

Credits

Author: Magnus Åberg (The Commits)

License

GNU Affero General Public License v3 or later (AGPLv3+) (AGPL-3.0-or-later)

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.4.tar.gz (20.8 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.4-py3-none-any.whl (28.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for ssss-1.3.4.tar.gz
Algorithm Hash digest
SHA256 24a46976d67d14d819936084ab14af07883c799c88260bb005cd1fb848fa76fd
MD5 284ed5731d22728f1ddf6aa57608aea9
BLAKE2b-256 6fd8fbb825e3dbfedf402c51b795c630eaff09f79599065647cb4f9a885392ac

See more details on using hashes here.

Provenance

The following attestation bundles were made for ssss-1.3.4.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.4-py3-none-any.whl.

File metadata

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

File hashes

Hashes for ssss-1.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 8ad03d8e81433cf4d99c0ed572613a7ac34e5c901877d4e30b59361e946103e5
MD5 0114c0a7b63844cb9f757bb54c1afd28
BLAKE2b-256 2bb357e6ed01af66d1b8fabcac8c59e31e6dd66dcc4c4fdba25eb8b5bae3b0f1

See more details on using hashes here.

Provenance

The following attestation bundles were made for ssss-1.3.4-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