README.md
March 18, 2026 · View on GitHub
perfekt 👌
Intro
perfekt is a release, changelog and versioning manager. It's easy to use and doesn't require any configuration to get it up and running.
It works with all package managers: pnpm, npm and yarn. perfekt detects the package manager from your packageManager field or lockfile and updates the matching lockfile during releases.
It can also return structured JSON for release and changelog, which makes it a good fit for CI jobs, scripts, and agents.
Convention
For perfekt to run with its full power, your project must follow the conventional commits specification, this allows it to know the type of changes introduced in a given commit.
If you want help enforcing that locally, commitlint is a good companion tool for validating commit messages before they land in git history.
If your project doesn't do it yet, you can start any time as there is no need for rewriting any git history, simply create an initial release which will contain all of the unconventional commits and after that start naming your commits accordingly.
If for some reason you can't follow the convention for your commits' names, you can still use perfekt but you will lose some of the features, like grouping the commits by type or ability to automatically determine the next release version based on unreleased changes using new keyword in the perfekt release new command, about which you can read more here.
Getting started
For a quick introduction and set up instructions head to the getting started section.
You can also view the entire documentation online at lekterable.github.io/perfekt
To install perfekt globally, run:
pnpm add -g perfekt
or
npm install -g perfekt
or
yarn global add perfekt
Badge
Would you like to let the whole world know that your project is under the perfekt management?
[](https://github.com/lekterable/perfekt)
[](https://github.com/lekterable/perfekt)