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:
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 (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.2.tar.gz (20.0 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.2-py3-none-any.whl (27.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ssss-1.3.2.tar.gz
  • Upload date:
  • Size: 20.0 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.2.tar.gz
Algorithm Hash digest
SHA256 e0258171e33b6642573468dcd54e38add106067dcec22474779f46d68ff31393
MD5 1ea0d9f827c8856f8eef23292cbcabd3
BLAKE2b-256 740d57b2d33c7e7ee756d7da0f25bd79ad3b5d6c49ea49a46925dbeda3d56d62

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: ssss-1.3.2-py3-none-any.whl
  • Upload date:
  • Size: 27.1 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ae42c7153a255aff29772d3b3e8de523decaba7e954243e00d09cf5291a5a97c
MD5 f7a44f7b6ddabfdacef716c34eb5bad7
BLAKE2b-256 25cd8ff8450ef4e7235d902e0db0b517a8171df51f364f5d31cb96123239feef

See more details on using hashes here.

Provenance

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