Contents
Getting started
Ecosystem & Architecture
Operational
- Development — make targets, quality gates, and automated testing
- Security — Subresource Integrity (SRI) and Content Security Policy (CSP)
- License — dual Apache-2.0 and MIT licensing
Themes
Twenty-six themes ship in this repository. Every one is held to the same
gates: WCAG AAA colour, a page-weight budget, and no third-party
requests.
| Theme | Category | Description |
|---|
| Apex | Portfolio | Executive portfolio theme: template inheritance, AAA-gated colour tokens, zero third-party requests. |
| Atlas | Publication | Editorial and knowledge-hub theme: serif reading column, citation-friendly structure, AAA-gated tokens. |
| Cadence | Marketing | Performance-cycling theme: cinematic dark stage, rider abstraction and evidence-led specifications. |
| Cipher | Developer Tools | Security utility theme: Diceware word tables, an entropy readout for every setting and a configuration console, with nothing sent over the network. |
| Control Centre | Developer Tools | Operations and security dashboard theme: sidebar app shell, a status ring joined by flows to the systems either side, KPI tiles, severity pills and evidence tables. |
| Covenant | Marketing | Private-capital theme: black, ivory and red geometry with rigorous portfolio narratives. |
| Hearth | Marketing | Furniture-catalogue theme: airy product staging, warm materials and practical ownership content. |
| Intent | Portfolio |
Each links to its own README for installation and layout details.
Overview
ssg-themes.github.io is engineered for speed, privacy, and accessibility. Built with Static Site Generator (SSG) and the Skeletonic Design System, it delivers lightning-fast static page generation, zero third-party tracking cookies, and responsive Apple Human Interface Guidelines (HIG) navigation.
Quick Start
Prerequisites
Ensure you have ssg installed via Cargo:
cargo install ssg
Local Build & Development
Clone the repository and compile the static assets:
git clone https://github.com/sebastienrousseau/ssg-themes.github.io.git
cd ssg-themes.github.io
# Build the gallery and all 26 themes into public/
make build
# Serve the built site locally at http://127.0.0.1:8099/
make preview
Features
- Static Site Generator (SSG) Compilation: High-throughput Markdown and Tera template processing with pre-rendered HTML.
- Apple HIG Responsive Navigation: Sticky blur glass header with horizontal/vertical element alignment, squarcle buttons, and mobile hamburger drawer.
- Subresource Integrity (SRI): SHA-384 cryptographic hashing on all external and internal stylesheets and scripts.
- Content Security Policy (CSP): Hardened security headers restricting unvetted origins while permitting high-performance execution.
- Full Client Search Engine: Instant multi-term indexing and live modal search via
search-index.json.
- System Theme Auto-Detection: Instant switching between Light, Dark, and System modes with zero visual flash.
- 100% WCAG AAA Compliance: High contrast ratios, full keyboard navigation, ARIA landmarks, and semantic heading hierarchies.
Technology Stack
| Component | Technology | Description |
|---|
| Static Engine | Static Site Generator (SSG) | High-speed Rust static site generator |
| Design Framework | Skeletonic CSS | Minimalist, zero-dependency layout engine |
| Icons & Assets | CloudCDN | Distributed edge CDN for SVG vector assets |
| Runtime | Vanilla ECMAScript | Zero runtime framework overhead |
Development
Build every theme, then run the gates. make check is the whole suite and is
what CI runs; the individual targets are there for a faster loop while you
work on one thing.
make build # build all themes into public/
make check # every gate: structure, contrast, weight, audit,
# responsive, AAA, links, pa11y, schema
make check-lighthouse # Mobile + desktop Lighthouse over gallery and themes
make screenshots # recapture the gallery screenshots from the build
Each gate reports what it measured, not just a pass: make check prints the
number of pages audited, token pairs compared and renders checked, so a gate
that silently stopped testing anything is visible as a dropped count.
Security
Every deployment adheres to strict security and integrity standards:
- Zero Inline Code Execution: All scripts are isolated and digest-verified.
- Cryptographic Asset Integrity: Guaranteed Subresource Integrity via SHA-384 digests.
- Privacy by Default: No user tracking, analytics cookies, or third-party fingerprinting.
License
Copyright © 2024 - 2026 Sebastien Rousseau. All rights reserved.
Licensed under the Apache License, Version 2.0 or the MIT license at your option.
