Early research preview — this project is an experiment and may change significantly.
Bloktastic

CLI Reference

Reference for core commands in bloktastic.

Install

npm install -g bloktastic

Commands

bloktastic init

bloktastic init [options]

Options:
  -y, --yes           Skip prompts and use defaults
  --space <id>        Storyblok space ID
  --region <region>   eu | us | ca | ap

bloktastic add

bloktastic add <package> [options]

Options:
  --prompt-only             Return prompt only
  --prompt-output <mode>    Where to send the prompt: clipboard | stdout | none
  --skip-schema             Skip Storyblok schema push
  --force                   Overwrite existing component

bloktastic search

bloktastic search <query> [options]

Options:
  -t, --type <type>      component | plugin | preset
  -c, --category <cat>   Category filter
  --tag <tag>            Tag filter

bloktastic list

bloktastic list [options]

Options:
  -t, --type <type>      Filter by package type
  -c, --category <cat>   Filter by category
  --installed            Show only installed packages

bloktastic info

bloktastic info <package>

bloktastic create

bloktastic create <type> <name> [options]

Options:
  -n, --namespace <ns>   Package namespace
  -o, --output <dir>     Output directory

bloktastic validate

bloktastic validate <path> [--quiet]

Environment Variables

Variable Description
STORYBLOK_OAUTH_TOKEN API token used for schema push operations.

Configuration

{
  "$schema": "https://bloktastic.com/schema/config.schema.json",
  "space": {
    "id": "123456",
    "region": "eu"
  },
  "preferences": {
    "defaultFramework": "astro",
    "outputDirectory": "./components/storyblok",
    "promptOutput": "clipboard"
  }
}