Generate a website from markdown with a minimum of fuss.
pnpm install -D @zeroasic/zauipnpm zaui dev- Type
oto open your browser.
More details in the guide at zaui.zeroasic.com.
- A preconfigured SvelteKit app with a Vite dev server and build.
- Tailwind CSS, and the Tailwind typography plugin.
- Markdown rendering based on Markdoc.
- A set of built-in website navigation and page components.
- A way to customize the design, and add your own Svelte components.
- Static publishing using the SvelteKit static adapter.
- TypeScript
- Contact and newsletter forms
- User signup and authentication.
The name 'zaui' originated from "Zero ASIC UI", where it powers the zeroasic.com website.
Inspiration for the developer experience of zaui came from VitePress. The main achitectural difference is that zaui can fetch and render markdown dynamically in the browser, similar to docsify.
Use npm, pnpm, or yarn. E.g.
pnpm install -D @zeroasic/zaui
zaui devlaunches a dev server to render a preview of the website while you edit content.zaui buildproduces a static build of the website files.
The zaui project directory can be passed as an argument E.g. zaui dev docs when your zaui project lives in the docs subdirectory of your repo.
For non-global installs, these commands should be added as package.json scripts E.g.
"scripts": {
"dev": "zaui dev",
"build": "zaui build"
}You can override the default directories with env vars. More details in zaui.js
- ZAUI_PROJECT_DIR defaults to current working directory, with other directories below that.
- ZAUI_CONTENT_DIR is where markdown files live - defaults to
./content - ZAUI_BUILD_DIR is where build output is written - defaults to
./build - ZAUI_SRC_DIR: is optional, where custom components live - defaults to
./src