https://github.com/habedi/template-zig-project

A template for Zig projects :lizard:
https://github.com/habedi/template-zig-project

project-template quality-of-life template zig zig-library ziglang

Last synced: about 1 year ago
JSON representation

A template for Zig projects :lizard:

• Host: GitHub
• URL: https://github.com/habedi/template-zig-project
• Owner: habedi
• License: mit
• Created: 2025-06-11T17:44:41.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-11T18:08:44.000Z (about 1 year ago)
• Last Synced: 2025-06-11T19:18:33.657Z (about 1 year ago)
• Topics: project-template, quality-of-life, template, zig, zig-library, ziglang
• Language: Zig
• Homepage:
• Size: 145 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
## Zig Project Template



  

    

  






[![Tests](https://img.shields.io/github/actions/workflow/status/habedi/template-zig-project/tests.yml?label=tests&style=flat&labelColor=282c34&logo=github)](https://github.com/habedi/template-zig-project/actions/workflows/tests.yml)

[![Lints](https://img.shields.io/github/actions/workflow/status/habedi/template-zig-project/lints.yml?label=lints&style=flat&labelColor=282c34&logo=github)](https://github.com/habedi/template-zig-project/actions/workflows/lints.yml)

[![Code Coverage](https://img.shields.io/codecov/c/github/habedi/template-zig-project?label=coverage&style=flat&labelColor=282c34&logo=codecov)](https://codecov.io/gh/habedi/template-zig-project)

[![CodeFactor](https://img.shields.io/codefactor/grade/github/habedi/template-zig-project?label=code%20quality&style=flat&labelColor=282c34&logo=codefactor)](https://www.codefactor.io/repository/github/habedi/template-zig-project)

[![Docs](https://img.shields.io/badge/docs-latest-007ec6?label=docs&style=flat&labelColor=282c34&logo=readthedocs)](docs)

[![License](https://img.shields.io/badge/license-MIT-007ec6?label=license&style=flat&labelColor=282c34&logo=open-source-initiative)](https://github.com/habedi/template-zig-project/blob/main/LICENSE)

[![Release](https://img.shields.io/github/release/habedi/template-zig-project.svg?label=release&style=flat&labelColor=282c34&logo=github)](https://github.com/habedi/template-zig-project/releases/latest)

This is a project template for Zig projects.

It provides a minimalistic project structure with pre-configured GitHub Actions, Makefile, and a few useful

configuration files.

I share it here in case it might be useful to others.

### Features

- Minimalistic project structure

- Pre-configured GitHub Actions for linting and testing

- Makefile for managing the development workflow and tasks like code formatting, testing, linting, etc.

- GitHub badges for tests, code quality and coverage, documentation, etc.

- [Code of Conduct](CODE_OF_CONDUCT.md) and [Contributing Guidelines](CONTRIBUTING.md)

### Getting Started

Check out the [Makefile](Makefile) for available commands to manage the development workflow of the project.

```shell

# Install system and development dependencies (for Debian-based systems)

sudo apt-get install make

make install-deps

```

```shell

# See all available commands and their descriptions

make help

```

### Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to make a contribution.

### License

This project is licensed under the MIT License ([LICENSE](LICENSE) or https://opensource.org/licenses/MIT)