Shards review
A free, open-source choice for resolving and locking Crystal project dependencies.
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
Shards is the dependency manager for Crystal applications and libraries. Developers define project metadata and dependencies in shard.yml, then Shards resolves declared version constraints and installs the project’s dependencies. It supports Windows, macOS, and Linux, and is distributed with Crystal releases. The tool is open source under the Apache License 2.0, making it a focused option for developers working within the Crystal ecosystem.
Its strongest workflow is reproducibility. Shards generates shard.lock so installations can use resolved dependency versions consistently. Dependency sources extend beyond standard Git repositories: the tool supports GitHub, GitLab, Bitbucket, Codeberg, Mercurial, Fossil, and local paths through symlinks. It can also run postinstall hooks for dependencies and install declared project executables. This gives Crystal projects several ways to organize dependencies while keeping project declarations in a dedicated shard.yml file.
Shards is a good fit for Crystal teams that want a free, open-source dependency manager with lockfiles and varied repository support. Its scope is narrower for organizations that require verified workspaces, private registry authentication, offline operation, or integrations. Those requirements may point toward an alternative package-management workflow. For Crystal projects centered on declared dependencies, version resolution, reproducible installation, and supported repository sources, Shards keeps the package-management layer closely aligned with the language.
Shards pros and cons
- Where it wins
- Reproducible installations through shard.lock lockfiles
- GitHub, GitLab, Bitbucket, Codeberg, Mercurial, and Fossil support
- Local path symlinks, hooks, and executable installation
- Where it doesn't
- No verified workspace support
- No private registry authentication
- No offline support or integrations
Shards fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update