From a0ff6870b89aa46a1167b2aa527d66a02702a5c8 Mon Sep 17 00:00:00 2001 From: crimson-knight Date: Sun, 19 Apr 2026 10:15:49 -0400 Subject: [PATCH] Clarify shards compatibility story --- README.md | 8 ++++++++ src/amber_cli/generators/native_app.cr | 2 +- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0b14ea0..325e24b 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,14 @@ sudo mv amber amber-lsp /usr/local/bin/ **Windows:** Use WSL2 or a virtual machine. Native Windows support is not currently available. +### Package Manager Compatibility + +Amber CLI is designed to work with upstream `crystal-lang/shards`, and we also +validate it against the additive fork currently distributed as `shards-alpha`. +The goal is straightforward: standard Amber workflows should continue to work +with plain `shards` commands, while compatible forks can add tooling without +changing how a new Amber project gets started. + ### Create Your First App ```bash diff --git a/src/amber_cli/generators/native_app.cr b/src/amber_cli/generators/native_app.cr index ca07901..9d51818 100644 --- a/src/amber_cli/generators/native_app.cr +++ b/src/amber_cli/generators/native_app.cr @@ -243,7 +243,7 @@ all: macos # --- First-time setup --- setup: - shards-alpha install || shards install || true + shards install || shards-alpha install || true @# crystal-audio shard name has a hyphen but source uses underscore @# Crystal's require resolution needs the underscore directory @if [ ! -e lib/crystal_audio ]; then \\