@datalyr/wizard

AI-powered CLI to install Datalyr SDKs in your project.

Quick Start

npx @datalyr/wizard

What it does

The wizard automatically:

1. Detects your framework (Next.js, React, Svelte, React Native, iOS, etc.)
2. Installs the appropriate Datalyr SDK(s)
3. Generates initialization code
4. Configures environment variables

Supported Frameworks

| Framework | Client SDK | Server SDK | |-----------|------------|------------| | Next.js | @datalyr/web | @datalyr/api | | React (Vite/CRA) | @datalyr/web | - | | SvelteKit | @datalyr/web | @datalyr/api | | React Native | @datalyr/react-native | - | | Expo | @datalyr/react-native | - | | iOS (Swift) | DatalyrSDK | - | | Node.js | - | @datalyr/api |

CLI Options

npx @datalyr/wizard [options]

Options:
  --api-key, -k    Your Datalyr API key (starts with dk_)
  --framework, -f  Framework to configure (auto-detected if not specified)
  --yes, -y        Skip confirmation prompts
  --dry-run        Show what would be done without making changes
  --json           Output plan as JSON (for programmatic use)
  --debug          Enable debug output
  --cwd            Working directory (defaults to current)
  --help, -h       Show help
  --version, -v    Show version

Examples

# Interactive wizard
npx @datalyr/wizard

# Non-interactive (for CI/CD)
npx @datalyr/wizard --api-key dk_xxx --yes

# Preview changes
npx @datalyr/wizard --dry-run

# Force specific framework
npx @datalyr/wizard --framework nextjs

# JSON output for LLM agents
npx @datalyr/wizard --json

LLM Agent Support

The wizard works with AI coding agents like Cursor and Bolt:

# In Cursor/Bolt prompt:
"Run npx @datalyr/wizard --api-key dk_xxx --yes to install Datalyr"

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Run locally
node dist/bin/wizard.js

# Run in watch mode
pnpm dev

License

MIT