Orison

A server and static site generator built on top of lit-html

Node.jsJavaScriptlit-htmlExpress

Live Site ↗ GitHub ↗

About

Orison is a lightweight static site generator and development server that uses lit-html for templating. It supports file-based routing, nested layouts, data files, partials, markdown rendering, and SPA-style navigation out of the box.

Features

File-based routing — pages map directly to the file hierarchy
Nested layouts — each directory can define its own layout.js wrapper
Data files — data.json files supply context to templates
Partials — reusable template fragments stored in /src/partials
Markdown support via markdown-it
SPA-style fragment navigation without full page reloads
Service worker integration for offline support
Can be used as a static site generator or a live development server

Get Started

Install npm install

Develop npm run serve

Build npm run build

Project Structure

my-site/
├── src/
│   ├── pages/          ← JS, HTML, or Markdown files become pages
│   │   ├── layout.js   ← Shared page wrapper (head, body shell)
│   │   ├── data.json   ← Data available to all pages via context
│   │   └── index.js    ← Generates /index.html
│   ├── partials/       ← Reusable template fragments
│   └── static/         ← Copied as-is to the build directory
└── docs/               ← Built output (served by GitHub Pages)