Ziex App on Render

A starter template for building web applications with Ziex deployed on Render.

Documentation →

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

Other platforms →

Project Structure

├── app/
│   ├── assets/         # Static assets (CSS, images, etc)
│   ├── 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

Development

zig build dev

App will be available at http://localhost:3000 with hot reload enabled.

Deploy to Render

Via Render Dashboard

Push this repo to GitHub
Go to Render and create a new Web Service
Select Deploy from GitHub repo
Render will auto-detect the render.yaml blueprint and configure:
- Environment: Docker
- Dockerfile Path: ./Dockerfile
- Health Check Path: /

Via Blueprint

This template includes a render.yaml blueprint. Click the deploy button above or:

Go to Render Blueprint Dashboard
Select this repository
Render will read render.yaml and configure the service automatically

Configuration

The app automatically reads the PORT environment variable provided by Render and binds to 0.0.0.0. No manual port configuration is needed.

Contributing

Contributions are welcome! For feature requests, bug reports, or questions, see the Ziex Repo.

README.md