mirror of
https://github.com/ziex-dev/ziex.git
synced 2026-07-21 02:59:36 -06:00
commit 016effdebb09ece43e559e39f950c6fc07143aee
Author: Nurul Huda (Apon) <me@nurulhudaapon.com>
Date: Sat Mar 21 04:44:35 2026 +0600
feat: include ziex_js in builder output
2.1 KiB
2.1 KiB
Ziex App on Cloudflare
A starter template for building web applications with Ziex deployed on Cloudflare Workers.
Getting Started
Prerequisites
1. Install ZX CLI
# Linux/macOS
curl -fsSL https://ziex.dev/install | bash
# Windows
powershell -c "irm ziex.dev/install.ps1 | iex"
2. Install Zig
brew install zig # macOS
winget install -e --id zig.zig # Windows
3. Install Node.js (for Wrangler)
Project Structure
├── app/
│ ├── assets/ # Static assets (CSS, images, etc)
│ ├── main.ts # Cloudflare Worker entrypoint
│ ├── main.zig # Zig entrypoint
│ ├── pages/ # Pages (Zig/ZX)
│ │ ├── layout.zx # Root layout
│ │ ├── page.zx # Home page
│ │ ├── client.zx # Client-side component
│ │ └── ...
│ └── public/ # Public static files (favicon, etc)
├── build.zig # Zig build script
├── build.zig.zon # Zig package manager config
├── wrangler.jsonc # Cloudflare Workers config
└── package.json
Usage
Development
zig build dev
App will be available at http://localhost:3000 with hot reload enabled.
Deploy to Cloudflare
npx wrangler deploy
Or click the Deploy to Cloudflare Workers button above for one-click deployment.
Contributing
Contributions are welcome! For feature requests, bug reports, or questions, see the Ziex Repo.