The official registry of Zig packages and applications for Zig Index.

Zig Index is a community-driven registry for discovering and sharing Zig packages, libraries, and applications. It provides:

• 📦 Package Discovery: Browse and search through curated Zig packages
• 🚀 Application Showcase: Find tools and software built with Zig
• 📊 Live Statistics: Real-time GitHub stats (stars, forks, issues)
• 📖 README Display: View project documentation directly
• 🔧 Installation Commands: Copy-to-clipboard zig fetch commands
• 👤 Developer Profiles: View contributors and their Zig projects
• 🔍 Advanced Search: Filter by category, license, and more

repositories/
├── applications/           # Applications built with Zig
│   ├── bun.json           # Bun JavaScript runtime
│   ├── tigerbeetle.json   # TigerBeetle database
│   └── zig-compiler.json  # Zig compiler itself
└── packages/              # Zig libraries and packages
    ├── capy.json          # Cross-platform GUI library
    ├── logly.json         # Logging library
    ├── mach.json          # Game engine & graphics toolkit
    ├── zig-std.json       # Standard library docs
    └── zls.json           # Zig Language Server

Fork the Zig Index registry repository on GitHub.

Create a file in src/registry/repositories/packages/your-package.json:

{
  "name": "Your Package Name",
  "owner": "github-username",
  "repo": "repository-name",
  "description": "A brief description of your package (max 200 chars)",
  "homepage": "https://your-docs-site.com",
  "license": "MIT",
  "category": "networking"
}

Create a file in src/registry/repositories/applications/your-app.json:

{
  "name": "Your Application Name",
  "owner": "github-username",
  "repo": "repository-name",
  "description": "A brief description of your application",
  "homepage": "https://your-app-site.com",
  "license": "MIT",
  "category": "development-tools",
  "download_url": "https://example.com/your-app-installer.exe"
}

Submit a PR with your changes. We'll review and merge it!

• name - The display name shown on the website
• owner - Your GitHub username or organization name
• repo - The exact repository name on GitHub
• description - A brief description of your project (keep it under 200 characters)

• homepage - Link to your documentation or project website
• license - Use SPDX identifiers (MIT, Apache-2.0, GPL-3.0, etc.)
• category - Helps users filter and discover your project
• download_url - Direct download link for pre-built binaries

Users can install packages directly using zig fetch:

# Using .tar.gz (recommended)
zig fetch --save https://github.com/{owner}/{repo}/archive/refs/tags/{version}.tar.gz

# Using .zip
zig fetch --save https://github.com/{owner}/{repo}/archive/refs/tags/{version}.zip

For repositories without releases, the main branch is used:

# Main branch (latest commit)
zig fetch --save https://github.com/{owner}/{repo}/archive/refs/heads/main.tar.gz

The website automatically generates these commands with copy-to-clipboard functionality!

After running zig fetch --save, add the dependency to your build.zig:

const std = @import("std");

pub fn build(b: *std.Build) void {
    const target = b.standardTargetOptions(.{});
    const optimize = b.standardOptimizeOption(.{});

    // Add dependency
    const dep = b.dependency("package-name", .{
        .target = target,
        .optimize = optimize,
    });

    const exe = b.addExecutable(.{
        .name = "my-app",
        .root_source_file = b.path("src/main.zig"),
        .target = target,
        .optimize = optimize,
    });

    // Import module from dependency
    exe.root_module.addImport("package-name", dep.module("package-name"));
    
    b.installArtifact(exe);
}

• ✅ Open source Zig projects on GitHub
• ✅ Projects with build.zig or build.zig.zon
• ✅ Well-documented projects with READMEs
• ✅ Active projects (updated within the last year)

• ❌ Closed source projects
• ❌ Non-Zig projects
• ❌ Abandoned/archived repositories
• ❌ Forks without significant changes
• ❌ Tutorial/example code (unless it's a library)

• Node.js 18+
• npm or pnpm

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

• Framework: Astro v5
• UI: React + Tailwind CSS v4
• Components: shadcn/ui
• Animations: Framer Motion
• Data Fetching: TanStack Query
• Caching: IndexedDB via Dexie.js
• Hosting: GitHub Pages

This registry is open source under the MIT License.

• Website: https://zig-index.github.io
• Repository: https://github.com/Zig-Index/zig-index.github.io
• Zig Language: https://ziglang.org
• Zig Discord: https://discord.gg/ziglang

We welcome contributions! Here's how you can help:

1. Add Projects: Submit PRs to add Zig packages/applications
2. Report Issues: Found a bug? Open an issue
3. Improve Code: PRs for bug fixes and features welcome
4. Spread the Word: Share Zig Index with the community!

Made with ❤️ by the Zig Community