Getting Started

This guide covers the shortest path from empty project to first installed component.

npx skills add https://github.com/bartundmett/bloktastic --skill bloktastic

Prerequisites

• Node.js 20 or newer
• pnpm (recommended) or npm
• Storyblok personal access token
• A Storyblok space ID

1. Install CLI

npm install -g bloktastic

Or run directly with:

npx bloktastic <command>

2. Set Token

export STORYBLOK_OAUTH_TOKEN="your-token"

Generate token in Storyblok Account Settings if you do not have one yet.

3. Initialize Project

bloktastic init

This creates bloktastic.config.json with space, region, and prompt preferences.

4. Add a Component

bloktastic add @bloktastic/hero

The command will:

1. Fetch package metadata from registry
2. Push schema to your Storyblok space
3. Resolve dependencies
4. Return or copy prompt text

5. Generate Frontend Code

Paste the prompt in your AI tool with your local stack context, for example:

Project stack:
- Astro
- Tailwind CSS
- TypeScript

Please generate a production-ready Storyblok Hero component.

Next

• Browse components
• Check all CLI commands
• Contribute a new package