---
title: The Projectfile Specification
description: ""
lang: en
tags: []
---

**Status:** maintained

## Origin

I hate multitude of files in the roots of my projects, so I decided to add
another one to rule them
all.

## What it does

The Projectfile specification describes “projectfile”, a simple hierarchical
file about a project.
It can be YAML, TOML or JSON.
There is a CLI tool that hides formats from you, reads and writes keys and
supports includes, interpolation and other interesting stuff.

## What is next

- bullying people to force them to abandon separate config files for their developement tools

## Fit

- You want to have a single source of truth for your tooling
- You like the idea of deterministic generation of 10+ various things from one thing
- You have fleet of projects with complex stacks
- You have more than one developer workflow
- You use CI/CD
- You have OCD

## Links

- [Repository on Codeberg](https://codeberg.org/projectfile/specification)
- [Issues on Codeberg](https://codeberg.org/projectfile/specification/issues)
- [Repository on GitHub](https://github.com/projectfile-org/specification)
- [Issues on GitHub](https://github.com/projectfile-org/specification/issues)
- [Repository on kiota.ch](https://kiota.ch/projectfile/specification)