mirror of
https://github.com/ziex-dev/ziex.git
synced 2026-07-20 18:49:33 -06:00
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.