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.3.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.3-py3-none-any.whl (28.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ssss-1.3.3.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.3.tar.gz
Algorithm Hash digest
SHA256 cdba0b72943d54032e6bebe6d660af72d5250f3192868f1899f562da7945c4fc
MD5 a4eea272aa7e200fad56f6cb6ba1d23e
BLAKE2b-256 b34cb77f15ad96b6ae31d875ccf9bd15e48161d91f5f71d24abcea9c80b6cbb0

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: ssss-1.3.3-py3-none-any.whl
  • Upload date:
  • Size: 28.6 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b2380d2045381dc02ffb7dcf97f26c34b7a9db5f1aecc97eefe6bdb8a3669c44
MD5 26340392b36ec363b3349a44da94bb67
BLAKE2b-256 9bf338473133078073717070d29486cdadd82b71966b172e5e63184f219c0abc

See more details on using hashes here.

Provenance

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