Kawaijs Docs - Learn by Playing
Author: Biagio Scaglia
Kawaijs is an open-source, web-native visual novel engine inspired by Ren'Py. Write indentation-based .kawa scripts, preview with kawa dev, try the browser playground, and build a static dist/ for GitHub Pages, Netlify, Vercel, or itch.io. Includes save/load, backlog, rollback, PWA, i18n, and built-in SEO (Open Graph, JSON-LD, sitemap, llms.txt). kawa build validates labels and hotspots; StoryVM.getState() returns a safe clone. Created by Biagio Scaglia. MIT licensed.
Enable JavaScript to play this interactive visual-novel documentation. Static answers follow for search and answer engines.
Frequently asked questions
What is Kawaijs?
Kawaijs is a web-native visual novel engine inspired by Ren'Py. It lets you write .kawa scripts and ship a static site that runs in any modern browser.
Who created Kawaijs?
Kawaijs was created by Biagio Scaglia. It is open source under the MIT license on GitHub.
How do I start a Kawaijs project?
Run npx kawa create my-novel, then npx kawa dev to preview with live reload, and npx kawa build to export a dist/ folder.
Can I deploy a Kawaijs novel to GitHub Pages?
Yes. kawa build produces a static dist/ with index.html, assets, PWA files, robots.txt, sitemap.xml, and llms.txt - ready for GitHub Pages or any static host.
Does Kawaijs support SEO?
Yes. kawa.config.json configures author, description, keywords, canonical URL, Open Graph, Twitter cards, JSON-LD (including FAQPage), favicon, sitemap, and llms.txt for search and answer engines.
Is Kawaijs free?
Yes. Kawaijs is free and open source under the MIT license.
How do I deep-link into a lesson or scene?
Use ?at=label (or ?label=) on the URL. Embed with ?embed=1. Restore shared progress with ?continue=token.