Kaizan website (B-lite)

Static site for GitHub Pages: plain HTML + CSS + a tiny vanilla-JS file, with no framework or bundler in production. The catch: every *.html file is generated by a single Python script (tools/build.py) from data dicts + template strings.

⚠️ Never hand-edit the generated *.html files — edit tools/build.py and rebuild. The HTML is build output. Any manual edit to a generated page is silently overwritten the next time python3 tools/build.py runs. This has caused real production regressions (a reverted GTM container id, a lost whitepaper CTA, a dropped hyperlink, stale pricing copy). The only hand-maintained HTML is white-paper/index.html (standalone — the build never writes it).

What's here

tools/build.py is the source of truth; everything below it marked (generated) is produced by running it.

tools/build.py                          ← SOURCE OF TRUTH. Data dicts + render_* templates.
assets/css/tokens.css                   Brand palette + base button styles
assets/css/site.css                     Component classes + responsive breakpoints
assets/js/site.js                       Mobile nav, mega menu, tab switchers
assets/img/                             Logos and investor marks
white-paper/index.html                  Whitepaper page — HAND-MAINTAINED (not generated)
.nojekyll                               Tells GH Pages to serve files as-is

index.html                              Home                              (generated)
product/index.html                      Product                           (generated)
pricing/index.html                      Pricing                           (generated)
integrations/index.html                 Integrations                      (generated)
security/index.html                     Security (in the Resources menu)  (generated)
research/index.html                     Our Research — 2026 report        (generated)
knowledge-hub/index.html                Knowledge Hub — client-success Q&A (generated)
faq/index.html                          FAQs (in the Resources menu)      (generated)
customers/index.html                    Clients (case-study index)        (generated)
customers/<slug>/index.html             Case-study detail pages           (generated)
about/index.html                        CEO essay + investors             (generated)
for/<persona-slug>/index.html           Persona pages                     (generated)
content/blog/<slug>/index.md            BLOG POSTS — Markdown source (hand-authored)
blog/index.html + blog/<topic>/<slug>/  Blog index, topic + post pages    (generated)
404.html                                Custom 404                        (generated)

Disabled pages (e.g. careers/) are removed on each build via _remove_page() in build.py, so stale output never lingers — re-enable by restoring the write(...) call.

Deploy to GitHub Pages

1. Add a remote and push:

   git remote add origin https://github.com/<you>/<repo>.git
   git push -u origin master
   

2. In the repo on GitHub: Settings → Pages → Source: select Deploy from a branch, branch master, folder / (root). Save. The site will be live at https://<you>.github.io/<repo>/ within a minute or two.

3. (Optional) Custom domain: add a CNAME file at the repo root containing your domain (e.g. kaizan.ai), then point your DNS at <you>.github.io. GitHub will provision HTTPS automatically.

If you host at a project subpath (e.g. <you>.github.io/<repo>/) all internal links work as-is because every page uses relative paths.

Editing content

The golden rule: change tools/build.py, never the .html output. To edit copy or add content:

1. Edit the relevant data dict near the top of the file (NAV, RESOURCES_MENU, PERSONAS, CASE_DATA, PRICING_TIERS, FAQ_DATA, RESEARCH_REPORT, KNOWLEDGE_HUB_DATA, POSTS, QUOTES, …) or the render_* template strings further down.
2. Rebuild:

   python3 tools/build.py
   

3. Commit both tools/build.py and the regenerated HTML, then push. (Keeping the source change and its output in the same commit is what prevents future divergence.)

Tip: after editing, run python3 tools/build.py && git status — the diff should only show files you expect. A surprise diff usually means someone had hand-edited the HTML.

Nav & dropdowns

The top nav is the NAV list. Two items are hover dropdowns rather than plain links: Personas (built from PERSONA_LIST) and Resources (built from RESOURCES_MENU). The Resources trigger is intentionally non-clickable — it only opens the dropdown. Add or reorder dropdown links by editing RESOURCES_MENU.

Adding or disabling a page

• Add: write a render_<page>() function, then add a write(ROOT / '<dir>' / 'index.html', render_<page>()) line to main(). Link it from NAV/RESOURCES_MENU/footer as needed.
• Disable: replace its write(...) call in main() with _remove_page(ROOT / '<dir>'). That stops generating it and deletes any already-deployed copy so it 404s instead of serving stale HTML. Keep the render_* function around for easy re-enable.

Adding a blog post

The blog at /blog/ is built from Markdown files — one folder per post:

content/blog/<slug>/index.md      ← frontmatter + Markdown body
content/blog/<slug>/cover.jpg     ← colocated images (referenced by filename)

Add a post by creating that folder, then python3 tools/build.py. The build (via tools/blog.py, using the vendored tools/markdown2.py) converts the Markdown, copies images to assets/img/blog/<slug>/, and writes /blog/index.html + /blog/<slug>/index.html.

This is the beginning of the README. Read the rest at the original. Read the full README ↗