Home /Modules/website-generator/DESIGN.md

DESIGN.md

website-generator/DESIGN.md · 70 line(s) · markdown

Website Generator — Design & Sign Model

This document is the contract between the SLeeLa generator and any front end (the JavaFX GUI, a CLI, or an HTTP caller). It describes the two inputs — a design and an ordered list of signs — and the output.

1. Design

A design is the global look applied to every page.

FieldTypeMeaning
themestringNamed theme, e.g. aurora, brutalist, editorial, neon.
brandcolor (hex)Primary brand color.
basecolor (hex)Page background base color.
accentcolor (hex)Accent / call-to-action color.
fontstringDisplay font family stack.
radiusint (px)Corner radius rhythm (0 = sharp, 24 = soft).
energyint 0..100The "exciting" dial — drives gradients, motion, contrast.
grammarenumLayout grammar: stack, split, grid, canvas.

energy is deliberately a single, legible dial so a user can go from calm (editorial, energy 10) to loud (neon, energy 95) without touching markup.

2. Signs

A sign is a semantic block. The generator owns the mapping from a sign to the markup/style it produces under the active design. Supported signs:

SignPrimary fieldsRenders as
navbrand, links[]Sticky top navigation.
heroheadline, subhead, ctaFull-bleed hero with energy gradient.
featuretitle, items[] {icon,title,body}Feature grid.
gallerytitle, images[]Responsive image grid.
pricingtitle, tiers[] {name,price,points[]}Pricing cards.
testimonialquote, authorPull-quote band.
ctaheadline, buttonConversion band in accent color.
richtexthtmlProse section.
footerbrand, columns[]Multi-column footer.

A sign carries a small set of string fields (keyed values). The generator fills in everything else — layout, spacing, color, motion — from the design, so the same sign list produces a radically different site under a different design.

3. Output

The emitter produces a single self-contained document per page:

The result is dependency-free: no external CSS/JS is required to view it.

4. Front-end contract

A front end submits a site description — a design plus an ordered sign list — and receives the generated HTML. In SLeeLa terms the generator exposes:

The JavaFX GUI mirrors these calls through SleelaJavaConnector; it never emits markup itself. See gui/.

Max Rupplin — MEARVK LLC — 2026