CLI Usage
Saastro blocks are installed using the shadcn CLI (v4+). No custom CLI needed.
Adding blocks
Once your registry is configured, install blocks with:
npx shadcn@latest add @saastro/hero-01Install multiple blocks at once:
npx shadcn@latest add @saastro/hero-01 @saastro/features-01 @saastro/pricing-01The CLI resolves dependencies against this registry, never against shadcn’s. Every registryDependencies entry is prefixed @saastro/, so a Saastro block only ever pulls Saastro primitives — all of them on Base UI.
That prefix is the whole point: a bare name like "button" would resolve against shadcn’s default registry and drop a Radix component into a Base UI project.
Most blocks need nothing at all: 12 of the 15 are pure .astro with zero JS and zero dependencies.
Available blocks
| Block | Group | Type | Registry dependencies |
|---|---|---|---|
hero-01 |
Hero | .astro |
— (none) |
hero-02 |
Hero | .astro |
— (none) |
hero-03 |
Hero | .astro |
— (none) |
features-01 |
Features | .astro |
— (none) |
features-02 |
Features | .astro |
— (none) |
pricing-01 |
Pricing | .tsx |
@saastro/button, @saastro/card, @saastro/badge, @saastro/separator |
cta-01 |
CTA | .astro |
— (none) |
faq-01 |
FAQ | .tsx |
@saastro/accordion |
testimonials-01 |
Testimonials | .astro |
— (none) |
footer-01 |
Navigation | .astro |
— (none) |
navbar-01 |
Navigation | .tsx |
@saastro/button, @saastro/sheet |
blog-grid-01 |
Content | .astro |
— (none) |
newsletter-01 |
CTA | .astro |
— (none) |
stats-01 |
Social Proof | .astro |
— (none) |
logos-01 |
Social Proof | .astro |
— (none) |
How it works
When you run npx shadcn@latest add @saastro/hero-01, the CLI:
- Fetches
https://ui.saastro.io/r/hero-01.json - Reads the component source code and dependency list
- Installs the
@saastro/*primitives that block declares — if any; 12 of the 15 declare none - Copies the block source into your project
Overwriting existing blocks
If you’ve modified a block and want to reset it:
npx shadcn@latest add @saastro/hero-01 --overwrite