https://github.com/forkwright/typikon
Fleet web-property substrate — Zola theme, frontmatter schemas, agentic scaffolding, strict CI gates
https://github.com/forkwright/typikon
Last synced: 3 days ago
JSON representation
Fleet web-property substrate — Zola theme, frontmatter schemas, agentic scaffolding, strict CI gates
- Host: GitHub
- URL: https://github.com/forkwright/typikon
- Owner: forkwright
- License: agpl-3.0
- Created: 2026-05-05T15:51:12.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-22T04:27:21.000Z (22 days ago)
- Last Synced: 2026-05-22T11:44:10.557Z (22 days ago)
- Language: HTML
- Size: 676 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Notice: NOTICE
Awesome Lists containing this project
README
# Typikon
> τυπικόν: the rule by which a thing of a given kind is enacted.
A Zola theme + frontmatter schemas + agentic scaffolding + CI gates. The fleet's web-property substrate. Sites consume typikon as a git submodule; typikon governs how those sites are built, validated, and deployed.
A typikon does not contain the service. It governs how the service is enacted.
## Design
Optimized for agentic operation. Humans should not need to develop here. The substrate ships:
- **Templates** (`templates/`) — Tera templates for base, page, section, journal.
- **Schemas** (`schemas/`) — JSON Schema for every content type. Frontmatter must validate before commit.
- **Scaffolds** (`scaffolds/`) — content templates copied by `bin/typikon-init`.
- **Binaries** (`bin/`) — `typikon-init`, `typikon-validate`, `typikon-check`, `typikon-refresh`, `typikon-migrate-template` (skeleton for schema-migration scripts). Idempotent CLIs with JSONL output where applicable.
- **CI** (`ci/`) — strict gate: build, CSP enforcement, internal + external link integrity, a11y, smoke. No pass = no deploy.
- **Headers** (`_headers.tmpl`, `_redirects.tmpl`) — Cloudflare Pages strict-CSP + redirect templates.
## Sovereignty
- Self-hosted WOFF2 fonts; zero external CDN dependencies at visitor runtime.
- Strict CSP with no `unsafe-inline` anywhere. Inline scripts and styles are CI failures.
- All third-party form actions explicitly allowlisted in CSP `form-action`.
## Topology
| Name | Role |
|------|------|
| **kanon** | the canon, the law |
| **basanos** | the touchstone, the test |
| **gnomon** | the indicator that makes pattern legible |
| **typikon** | the rule of execution for fleet web properties |
## Usage
```bash
# Scaffold a new consumer site
bin/typikon-init /path/to/new/site
# Validate content against schemas
bin/typikon-validate /path/to/consumer/site
# Run all CI gates locally
bin/typikon-check /path/to/consumer/site
# Refresh a consumer site against the latest typikon main
# (run from the consumer site root; bumps the submodule + re-renders
# every substituted template; stages the diff but doesn't commit).
themes/typikon/bin/typikon-refresh
```
See `docs/AGENTIC.md` for the agent contract, `docs/SCHEMAS.md` for the frontmatter reference, `docs/BOOTSTRAP.md` for the scaffolder behavior.
## License
AGPL-3.0-or-later. See LICENSE and NOTICE.
Self-hosted fonts under `static/fonts/` are OFL-1.1; see NOTICE for attributions.