release: v0.1.0-dev.978 from ziex-dev/ziex

Author: github-actions[bot]

.gitattributes

@@ -0,0 +1,3 @@
+* text=auto eol=lf
+# Make .zx files be treated as .zig files on GitHub for syntax highlighting
+*.zx text eol=lf linguist-language=Zig

.gitignore

@@ -0,0 +1,3 @@
+.zig-cache/
+zig-out/
+node_modules/

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025 Nurul Huda (Apon).
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,95 @@
+# Ziex App with Postgres
+
+>This is a starter template for building web applications with [Ziex](https://ziex.dev), a full-stack web framework for Zig.
+
+**[Documentation →](https://ziex.dev)**
+
+## Getting Started
+
+### 1. Install ZX CLI
+
+#### Linux/macOS
+```bash
+curl -fsSL https://ziex.dev/install | bash
+```
+
+#### Windows
+```powershell
+powershell -c "irm ziex.dev/install.ps1 | iex"
+```
+
+### 2. Install Zig
+```bash
+brew install zig # macOS
+winget install -e --id zig.zig # Windows
+```
+[_Other platforms →_](https://ziglang.org/learn/getting-started/)
+
+
+## Project
+
+```
+├── 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 counter component
+│   │   └── ...
+│   └── public/         # Public static files (favicon, etc)
+├── build.zig           # Zig build script
+├── build.zig.zon       # Zig package manager config
+└── README.md           # Project info
+```
+
+## Usage
+
+### Development
+```bash
+zig build dev
+```
+App will be available at [`http://localhost:3000`](http://localhost:3000). with hot reload enabled.
+
+### Serve Production Build
+```bash
+zig build serve --release=fast
+```
+
+### Exporting as Static Site
+```bash
+zig build zx -- export
+```
+This will create a `dist/` directory with the static export of your app. You can deploy the contents of `dist/` to any static hosting provider (Netlify, Vercel, GitHub Pages, etc) or serve it with any static file server.
+
+### Deployment
+
+```bash
+zig build zx -- bundle
+```
+
+This will create a `bundle/` directory with the binary and static assets needed to run your app. You can deploy the contents of `bundle/` to any VPS.
+
+
+### [ZX CLI](https://ziex.dev/reference#cli) Commands
+```bash
+zig build zx -- [command] [options]
+```
+
+All ZX CLI commands are available under `zig build zx -- [command]`. For example, to run auto formatter:
+```bash
+zig build zx -- fmt .
+```
+
+## Contributing
+
+Contributions are welcome! Feel free to open issues or pull requests. For feature requests, bug reports, or questions, see the [Ziex Repo](https://github.com/ziex-dev/ziex).
+
+## Links
+
+- [Documentation](https://ziex.dev)
+- [Discord](https://ziex.dev/r/discord)
+- [Topic on Ziggit](https://ziex.dev/r/ziggit)
+- [Project on Zig Discord Community](https://ziex.dev/r/zig-discord) (Join Zig Discord first: https://discord.gg/zig)
+- [GitHub](https://github.com/nurulhudaapon/ziex)
+- [Zig Language](https://ziglang.org/)

app/Context.zig

@@ -0,0 +1,3 @@
+const Database = @import("db/Database.zig");
+
+db: Database

app/assets/style.css

@@ -0,0 +1,63 @@
+body {
+    margin: 0;
+    font-family: sans-serif;
+    font-size: 1.4rem;
+    line-height: 1.6;
+    color: white;
+    background-color: black;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    text-align: center;
+    height: 100vh;
+}
+
+a {
+    color: #ffffff;
+    font-size: 1rem;
+    text-decoration: none;
+}
+
+button {
+    padding: 2px;
+    min-width: 100px;
+    font-size: 0.8rem;
+    border-radius: 5px;
+    margin: 3px;
+    border: 1px solid #ffffff;
+    background-color: transparent;
+    color: #ffffff;
+    cursor: pointer;
+    transition: all 0.3s ease;
+    &:hover {
+        background-color: #ffffff;
+        color: #000000;
+    }
+}
+
+.counter-row {
+    height: 150px;
+    margin: 10px;
+    display: flex;
+    gap: 20px;
+    justify-content: center;
+    align-items: center;
+}
+
+.counter-row > * {
+    min-width: 150px;
+}
+
+.counter-plus {
+    width: 70px;
+    display: inline-block;
+}
+
+.link-row {
+    display: flex;
+    gap: 10px;
+    justify-content: center;
+    align-items: center;
+    margin: 20px;
+}

app/db/Database.zig

@@ -0,0 +1,41 @@
+const std = @import("std");
+const pg = @import("pg");
+
+const Database = @This();
+
+pool: *pg.Pool,
+
+pub fn getCount(self: Database) !i64 {
+    var result = try self.pool.query("SELECT count FROM ziex", .{});
+    defer result.deinit();
+
+    if (try result.next()) |row|
+        return row.get(i64, 0);
+
+    _ = try self.pool.exec("INSERT INTO ziex (count) VALUES (0)", .{});
+    return 0;
+}
+
+pub fn setCount(self: Database, count: i64) !void {
+    _ = try self.pool.exec("UPDATE ziex SET count = $1", .{count});
+}
+
+pub fn setup(self: Database) !void {
+    _ = try self.pool.exec(@embedFile("migrations/init.sql"), .{});
+}
+
+pub fn init(allocator: std.mem.Allocator, uri: []const u8) !Database {
+    if (uri.len == 0) return error.InvalidDatabaseUrl;
+
+    const pgUri = try std.Uri.parse(uri);
+    std.log.info("DB: {s}", .{try pgUri.getHostAlloc(allocator)});
+    const pool = try pg.Pool.initUri(allocator, pgUri, .{ .size = 4 });
+
+    const db: Database = .{ .pool = pool };
+    try db.setup();
+    return db;
+}
+
+pub fn deinit(self: *Database) void {
+    self.db_pool.deinit();
+}

app/db/migrations/init.sql

@@ -0,0 +1,5 @@
+-- Initialize the database schema
+CREATE TABLE IF NOT EXISTS ziex (
+    id SERIAL PRIMARY KEY,
+    count BIGINT NOT NULL
+);

app/main.zig

@@ -0,0 +1,24 @@
+const std = @import("std");
+const zx = @import("zx");
+const Context = @import("Context.zig");
+
+pub fn main() !void {
+    if (zx.platform == .browser) return zx.Client.run();
+    if (zx.platform == .edge) return zx.Edge.run();
+
+    var gpa = std.heap.DebugAllocator(.{}){};
+    const allocator = gpa.allocator();
+    defer _ = gpa.deinit();
+
+    const db_uri = std.process.getEnvVarOwned(allocator, "DATABASE_URL") catch
+        "postgresql://postgres:db_password@localhost:5432/ziex";
+
+    var ctx: Context = .{ .db = try .init(allocator, db_uri) };
+    const app = try zx.Server(*Context).init(allocator, .{}, &ctx);
+    defer app.deinit();
+
+    app.info();
+    try app.start();
+}
+
+pub const std_options = zx.std_options;

app/pages/actions/client/page.zx

@@ -0,0 +1,28 @@
+pub fn Page(ctx: zx.PageContext) zx.Component {
+    return (
+        <main @allocator={ctx.arena}>
+            <EventForm @rendering={.client} />
+        </main>
+    );
+}
+
+pub fn EventForm(ctx: *zx.ComponentContext) zx.Component {
+    const count = ctx.state(i32, 1);
+    return (
+        <button onclick={ctx.bind(onclick)}>
+            Click Me {count}
+        </button>
+    );
+}
+
+fn onclick(e: *zx.client.Event.Stateful) void {
+    const c = e.state(i32);
+    c.set(c.get() + 1);
+    zx.log.info("Count> {d}. \n", .{c.get()});
+}
+
+pub const options: zx.PageOptions = .{
+    .methods = &.{ .GET, .POST },
+};
+
+const zx = @import("zx");