prism

✨ Just describe what you want to build, and watch it happen.

An AI-powered project generator that understands your requirements and builds production-ready apps through conversation. No memorizing commands, no perfect syntax required - just explain your idea and let prism do the heavy lifting.

🚀 NEW in v0.0.26:

• --preset Parameter 🎯 - Skip the interactive preset selection with --preset auth, --preset social, etc.
• Streamlined Quick Creation - Combine presets with other parameters for one-command project creation
• Non-Interactive Preset Support - Perfect for automation and CI/CD workflows

🚀 Recent in v0.0.25:

• Claude Code Commands 🤖 - Generate custom slash commands for Claude Code with prism command
• Dynamic Command Composition - Commands built from base templates + features + configurations
• All Project Types Supported - Web, Headless, Library, Go, Zig, and Ghost commands
• Ghost CMS Support 👻 - Create working Ghost installations with Docker auto-start

🚀 Recent Features:

• Prompt Catalog System 🆕 - Browse, search, and create projects from curated prompts with prism prompts
• One-Click Project Creation - prism use social-media my-app creates complete projects instantly
• Comprehensive Prompt Commands - Search, filter, and discover project templates by category and difficulty
• Go & Zig Support - Build Go APIs with Encore.dev integration and Zig projects including WASM
• Ghost CMS Support 👻 - Create Ghost themes, local installations, and API integrations
• BigBlocks v0.0.17 Support - Enhanced with Type 42 Master Keys and BAP Profile Sync
• Intelligent Component Selection - AI selects optimal components from 96+ available

🚀 The Magic of Prism

🤖 AI-Powered Understanding

"I want a social app with Bitcoin login" → Complete app with auth, posts, and wallet features

💬 Conversational Flow

• No need to memorize commands or options
• Prism asks clarifying questions when needed
• Iterates until your project builds perfectly
• Forgiving of typos, unclear requests, and changing requirements

🧩 Smart Plugin Integration

• AI selects the right components for your needs
• NEW: BigBlocks intelligence picks optimal components from 96 available
• Automatically configures complex integrations
• Handles all the webpack configs, environment variables, and boilerplate

⚡ One-Shot Success

• Tests the build before finishing
• Fixes issues automatically
• Delivers a working project every time

🎨 Parallel Variant Generation (NEW!)

• Generate 3 project variants simultaneously
• Compare them side-by-side in your browser
• Pick the best implementation visually

🎯 How It Actually Works

$ prism

✨ What would you like to build today?
> I need a marketplace app where users can login with Bitcoin and trade NFTs

🤔 Sounds great! Let me ask a few questions to get this perfect:
- Should users be able to create posts about their listings?
- Do you want real BSV payments or just a demo?
- Any specific UI style you prefer?

[Prism generates your complete app with:]
✅ Bitcoin authentication with encrypted backups
✅ NFT marketplace components
✅ Social features for engagement  
✅ Wallet integration for payments
✅ All configurations handled automatically

📊 Perfect for technical projects too:

$ prism

✨ What would you like to build today?
> Analytics dashboard for tracking developer activity

🎯 Perfect! I can set this up quickly with a Next.js preset.

[Prism creates:]
✅ Dashboard layout with data visualization
✅ Chart components and metric cards  
✅ Real-time data updates
✅ Professional analytics interface

📦 Installation

Using Bun (Recommended)

bunx init-prism@latest

Using NPM/NPX

npx init-prism@latest

🔑 Using with AI Generation

For AI-powered component generation, you have two options:

🚀 With Claude Code (Recommended - Much More Efficient!)

# If you have Claude Code installed, prism will automatically use it
# This is MUCH more efficient - uses 90% fewer tokens and completes faster
bunx init-prism@latest

# Claude Code handles all the iteration, testing, and fixes autonomously
# You just describe what you want, and get a perfect working project

Authentication Options for Claude Code:

# Option 1: Use your Claude subscription (no API key needed)
# Just make sure you're logged in with: claude login
bunx init-prism@latest --use-claude-subscription

# Option 2: Force Claude Code even without subscription
# (Will use Claude Code with your API key)
ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY bunx init-prism@latest --use-claude-code

# Option 3: Disable Claude Code entirely (use direct API only)
bunx init-prism@latest --no-claude-code

📱 With API Key (Direct Anthropic API)

# For users without Claude Code, use your API key
ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY bunx init-prism@latest

# Or install globally for easier access
bun install -g init-prism
prism  # Uses your shell environment directly

Why Claude Code Integration is Better:

• ⚡ 90% fewer tokens - Claude Code handles iteration internally
• 🎯 No back-and-forth - Gets it right the first time
• 🔧 Autonomous testing - Builds and fixes issues automatically
• ⏱️ Faster completion - Direct iteration instead of API round-trips
• 🧠 Smarter context - Uses your local codebase for better understanding

🚀 The Efficiency Revolution

Without Claude Code Integration:

1. prism sends requirements → Claude API
2. Claude generates code → prism writes files
3. Build fails with type errors → back to Claude API
4. Claude fixes errors → prism writes fixes
5. Still has issues → another API round-trip
6. Result: 10+ API calls, lots of tokens, slower iteration

With Claude Code Integration:

1. prism delegates to Claude Code → Claude Code takes over completely
2. Claude Code generates, tests, fixes, and iterates locally
3. Claude Code builds repeatedly until everything works
4. Result: 1 delegation call, Claude Code does the heavy lifting autonomously

This is why you'll use 90% fewer tokens and get much better results - prism kickstarts the process with templates and plugin configuration, then Claude Code takes over to perfect everything.

🎯 Quick Start

Option 1: Configuration File (Recommended for Teams)

Create a .prism configuration file in your project directory:

# Initialize a config file
prism init

# Edit .prism to match your needs
# Then just run:
prism

Sample .prism file:

name: my-social-app
type: web
preset: social
requirements: A Twitter-like social app with Bitcoin authentication and tipping features
plugins:
  - bigblocks
  - drizzle
useClaudeCode: true
skipPrompts: true
pluginAnswers:
  bigblocks:
    features: [auth, social, wallet]

Option 2: Just Tell Prism What You Want

$ prism

┌  BUILD STUFF FASTER
│  [ASCII art banner]
│  Create Modern Projects with brilliance
│
│  ✨ Let's build something amazing together!
│
◆  What would you like to build today?
│  I want a Twitter clone but with Bitcoin tipping  ← You type this
│
🤖 Understanding your request...
   Detected social media keywords - perfect for BigBlocks social components

🎯 Perfect! I can set this up quickly with a Next.js preset.
   Recommended preset: social
   Recommended components: bigblocks

◆  Does this sound right?
│  ● Yes, let's do it!
│  ○ Let me customize  
│  ○ That's not what I meant

🚀 Creating your app...
[Auto-creates project with social preset + AI requirements]

Or Use Quick Commands (If You Know Them)

prism next my-app            # Quick Next.js with AI assistance
prism --next                 # Even faster
prism ghost my-theme         # Create Ghost theme/installation/integration
prism command my-commands    # Generate Claude Code slash commands
prism use social-media app   # Create from prompt template
prism prompts list          # Browse available prompts
prism plugins list          # Browse available components

The AI Handles Everything Else

• Asks clarifying questions
• Selects appropriate plugins
• Configures all integrations
• Tests the build
• Fixes any issues
• Delivers a working project

🧠 Behind the AI Magic

When you describe your project, prism:

1. Understands Intent - Natural language processing extracts your requirements
2. Asks Smart Questions - Only what's needed to clarify ambiguity
3. Selects Components - Chooses from 36+ BigBlocks components, UI libraries, databases
4. Configures Everything - Webpack, TypeScript, environment variables, providers
5. Generates Code - Creates a complete, working application
6. Verifies Success - Builds the project and fixes any issues
7. Delivers Results - A production-ready app in under a minute

The AI Handles:

• 🔧 Complex webpack configurations for Bitcoin libraries
• 🔐 Authentication setup with proper encryption
• 🎨 UI component integration and theming
• 📦 Dependency compatibility and resolution
• 🏗️ Project structure and best practices
• ✅ Build verification and error recovery

🏗️ Project Types

🌐 Web Applications

Built on Next.js 15 with:

• App Router with Server Components
• TypeScript strict configuration
• Tailwind CSS v4+ (security-compliant)
• Biome linting and formatting
• Critical BSV package webpack configuration

🔧 Headless Services

Built on Bun with:

• Elysia framework for APIs
• Worker processes and background jobs
• Database integrations (Drizzle/Prisma)
• TypeScript strict mode

📚 Libraries

Built with Vite + TypeScript:

• Browser, Node.js, or Universal targets
• Clean project structure and dependencies
• Focused plugin ecosystem for utilities
• Optimized for reusable components and utilities

🐹 Go Projects (NEW!)

Professional Go development with:

• Templates: Minimal, API Server, CLI Tool
• Encore.dev Integration: Cloud-native backend framework (optional)
• API Frameworks: Gin or Echo for REST APIs
• CLI Framework: Cobra for command-line tools
• Docker Support: Multi-stage builds included
• AI Enhancement: Generate Go code with natural language

⚡ Zig Projects (NEW!)

High-performance Zig development:

• Templates: Minimal executable, Library, WebAssembly
• WASM Support: Browser-ready WebAssembly modules
• Build System: Modern build.zig configuration
• Testing: Built-in test runner setup
• Examples: Interactive HTML demos for WASM
• AI Enhancement: Generate Zig code from descriptions

👻 Ghost CMS Projects (NEW!)

Professional publishing platform:

• Templates:
  • Installation: Working Ghost CMS with Docker (default)
  • Theme: Handlebars theme development
  • Integration: TypeScript API client
• Auto-Start: Ghost launches automatically at http://localhost:2368
• Docker Setup: Complete containerized environment
• Development Tools: Ghost-CLI integration for themes
• API Access: Content API and Admin API support

🤖 Claude Code Commands (NEW!)

Generate custom slash commands for Claude Code:

• Dynamic Composition: Commands built from templates + features + configs
• All Project Types: Web, Headless, Library, Go, Zig, Ghost commands
• Smart Templates:
  • All: Commands for every project type
  • Web-focused: Next.js development commands
  • API-focused: Backend and service commands
  • Custom: Choose your own combination
• Usage: Copy .claude/commands/ to any project for instant commands
• Examples: /project:create-web, /project:add-auth, /project:setup-docker

📊 Project Type Comparison

| Feature | Web Apps | Headless | Libraries | Go | Zig | Ghost | Commands | |---------|----------|----------|-----------|-----|-----|-------|----------| | Maturity | ✅ Production-ready | ✅ Production-ready | ✅ Stable | ✅ Stable | ✅ Stable | ✅ Stable | ✅ NEW | | Plugin Support | ✅ 7+ plugins | ✅ 5+ plugins | ✅ 4 focused | ➖ AI only | ➖ AI only | ✅ 3 plugins | ➖ N/A | | BigBlocks UI | ✅ All 96 components | ➖ Server-focused | ➖ Utility-focused | ❌ N/A | ❌ N/A | ❌ N/A | ➖ Commands | | AI Integration | ✅ Excellent | ✅ Good | ✅ Streamlined | ✅ Good | ✅ Good | ✅ Good | ✅ Excellent | | Best For | User-facing apps | APIs & services | Reusable utilities | Systems & APIs | Performance | Publishing | Automation | | Frameworks | Next.js 15 | Bun/Elysia | Vite | Gin/Echo | Native | Ghost/Docker | Claude Code |

🧩 Plugin System (AI Selects These For You!)

You don't need to know about these - the AI picks the right ones based on your description. But if you're curious:

Available Building Blocks

🎨 UI & Styling

• BigBlocks v0.0.17 - 96 Bitcoin-native components with latest enhancements!
  • 🔐 Authentication: Bitcoin login, encrypted backups, user management
  • 📱 Social: Posts, likes, follows, feeds, user interactions
  • 💰 Wallet: Send BSV, view balances, transaction history
  • 🛒 Marketplace: Product listings, buy/sell, trading interface
  • 👤 Profile: User profiles, BAP identity, multi-device support
  • 🆕 Drag & Drop: Beautiful file upload zones with animated borders
  • 🎨 Responsive Design: Mobile-first with intelligent responsive utilities
  • 🎭 52+ Themes: Advanced theme system with sophisticated color palettes
• shadcn/ui - Beautiful, accessible components with Radix UI

🗄️ Database & Storage

• Drizzle ORM - When you need "a database" or "data persistence"
• Prisma - For complex data relationships

🚀 Deployment

• Vercel - Optimized Next.js hosting
• Netlify - Static site deployment

Manual Plugin Commands (Optional)

# List plugins by category
prism plugins list ui
prism plugins list database

# Search plugins
prism plugins search bitcoin
prism plugins search database

# Show detailed plugin info
prism plugins show bigblocks
prism plugins show shadcn

# List all categories
prism plugins categories

📝 Prompt Catalog System (NEW!)

⚡ Create projects instantly from curated templates

Skip the conversation and jump straight to building with our growing collection of expert-crafted prompts. Each prompt includes detailed specifications, recommended components, and estimated completion times.

🎯 One-Click Project Creation

# Browse available prompts
prism prompts list

# Create a social media platform instantly  
prism use social-media my-twitter-clone

# Create a professional Bitcoin wallet
prism use bitcoin-wallet my-wallet-app

# Create an NFT marketplace
prism use nft-marketplace my-marketplace

🔍 Discovery & Search

# Search by keywords
prism prompts search bitcoin        # Find Bitcoin-related prompts
prism prompts search social         # Find social platform prompts
prism prompts search marketplace    # Find marketplace prompts

# Browse by category
prism prompts list social           # Social platforms
prism prompts list wallet           # Wallet & payments
prism prompts list marketplace      # NFT & trading platforms

# Show featured prompts
prism prompts featured              # Curated highlights

# Get detailed information
prism prompts show social-media     # Full prompt details with preview

📊 Current Prompt Collection

| Prompt | Category | Difficulty | Time | Description | |--------|----------|------------|------|-------------| | social-media | 👥 Social | Intermediate | 4-6h | Twitter-like platform with Bitcoin tipping | | bitcoin-wallet | 💰 Wallet | Advanced | 6-8h | Professional wallet with multi-sig support | | nft-marketplace | 🛍️ Marketplace | Advanced | 8-12h | OpenSea-style NFT trading platform |

🏷️ Prompt Categories

• 👥 Social Platforms - Social media, messaging, community apps
• 💰 Wallet & Payments - Bitcoin wallets, payment systems, financial tools
• 🛍️ Marketplaces - NFT, token, and digital asset trading
• 📈 DeFi & Finance - Lending, trading, decentralized finance
• 🎮 Gaming - Blockchain games, play-to-earn, entertainment
• 🏢 Enterprise - Business tools, enterprise applications
• 🎓 Education - Learning platforms, certification systems
• 📝 Content - Publishing, blogging, media sharing

✨ Smart Features

• Difficulty Ratings - Beginner, Intermediate, Advanced with time estimates
• Component Hints - Auto-selects optimal BigBlocks components
• Project Type Matching - Compatible with web, headless, library, Go, Zig
• Detailed Previews - See prompt content before creating projects
• Featured System - Highlighted prompts for popular use cases

🚀 Coming Soon

• Community Prompts - User-contributed templates
• Remote Catalogs - External prompt repositories
• Prompt Versioning - Template updates and improvements
• Custom Categories - Personalized prompt organization

🤖 Intelligent Build Scripts

Automated repository maintenance and release validation powered by Claude Code

🔧 Maintenance Scripts

Keep your repository healthy with AI-powered maintenance that makes intelligent decisions about updates, security, and code quality.

# Monthly maintenance (recommended)
bun run maintenance              # Full maintenance with AI analysis

# Targeted maintenance
bun run maintenance:deps         # Dependency updates only
bun run maintenance:security     # Security audit and fixes
bun run maintenance:cleanup      # Code quality improvements

# Safe preview mode
bun run maintenance:dry          # See what would change

What the AI does:

• 🔍 Smart Dependency Updates - Researches breaking changes, applies security patches, skips risky updates
• 🛡️ Security Auditing - Finds vulnerabilities, applies fixes, reviews code for security issues
• 🧹 Code Quality - Removes dead code, fixes TypeScript errors, improves organization
• 📚 Documentation Updates - Keeps README and examples current with dependency changes

🚀 Pre-Publish Validation

Ensure release quality with comprehensive validation before publishing to npm.

# Full release validation
bun run pre-publish             # Complete validation with AI review

# Quick validation
bun run pre-publish:quick       # Skip AI validation (faster)
bun run validate               # Preview validation checks

Validation checks:

• ✅ Version Management - Semver compliance, proper increments, changelog consistency
• ✅ Git State - Clean repository, proper branch, no duplicate tags
• ✅ Build Quality - TypeScript compilation, tests pass, lint checks
• ✅ Security - Vulnerability scans, dependency audits
• ✅ AI Review - Claude Code performs comprehensive release readiness assessment

🎯 Smart Automation Features

• Creates maintenance branches - Never loses original code
• Intelligent decision making - AI researches updates before applying them
• Build verification - Ensures changes don't break anything
• Detailed reporting - Know exactly what changed and why
• Version validation - Prevents publishing mistakes
• Dry-run modes - Preview before making changes

See scripts/README.md for complete documentation and advanced usage.

🪙 Bitcoin Integration

Quick Bitcoin App Setup

$ prism next my-bitcoin-app

┌   Create Next.js App - Quick Mode 
│
◆  Choose a preset:
│  ○ Minimal (Just Next.js + TypeScript + Tailwind)
│  ● With Authentication  ← Select this for Bitcoin features
│  ○ Full Stack
│  ○ E-commerce  
│  ○ Social Platform
│  ○ Custom
└

✨ Perfect! I'll set up Bitcoin authentication with BigBlocks...
[Creates complete app with all configurations]

What you get:

• Bitcoin-based login/signup with encrypted backups
• Multi-device support with backup restoration
• OAuth integration (Google, GitHub, Twitter)
• BAP (Bitcoin Attestation Protocol) identity
• All webpack configs for BSV packages handled automatically

Automatic Configuration

The tool automatically configures:

• Next.js webpack for BSV packages (@bsv/sdk, bsv-bap)
• Client-side fallbacks for Node.js modules
• Proper transpilation for Bitcoin libraries
• Environment variables and providers

🎨 UI Component Systems

shadcn/ui Integration

• Copy-paste components philosophy
• Radix UI primitives with Tailwind CSS
• Full TypeScript support
• Accessible by default

BigBlocks Components

• 36+ Bitcoin-specific components
• CLI-based selective installation
• Social, wallet, and marketplace features
• Built-in BSV blockchain integration

💡 Example Conversations

Building a Social App

You: "I want to build a social media app"
Prism: "Awesome! Will users need to create accounts?"
You: "Yes, but I want it to use Bitcoin instead of passwords"
Prism: "Perfect! I'll set up BigBlocks auth. Want posts and likes too?"
You: "Yeah, and maybe user profiles"
Prism: "Got it! Building your app with auth, posts, profiles, and social features..."
[30 seconds later: Complete working app]

Creating a Go API

You: "I need a Go API with Encore"
Prism: "🎯 Perfect! Let's create a go project."
[Detects Go and Encore keywords]
Prism: "Select a Go template: API Server"
Prism: "Would you like to use Encore.dev? Yes"
[Creates cloud-native backend with Encore framework]

Building Zig WASM

You: "Build a Zig WebAssembly module"
Prism: "🎯 Perfect! Let's create a zig project."
[Creates WASM template with example HTML]
Prism: "Build with: zig build"
Prism: "Serve demo: python3 -m http.server 8000"
[Complete WASM module with JavaScript bindings]

Creating a Marketplace

You: "Build a marketplace"
Prism: "What kind of items will be sold?"
You: "Digital art and NFTs"
Prism: "Should sellers be able to create storefronts?"
You: "That would be cool"
Prism: "I'll include marketplace components, wallet integration, and storefront features..."
[Complete e-commerce platform ready]

When You're Not Sure

You: "I want to build something cool with Bitcoin"
Prism: "I can help! Here are some ideas:
  - Social platform with tipping
  - NFT marketplace
  - Decentralized blog
  - Wallet with social features
Which sounds interesting?"

🤖 Non-Interactive Mode (For Automation)

Perfect for CI/CD pipelines, scripts, or when you know exactly what you want:

Direct Creation with Requirements

# Create a dashboard without any prompts
prism dashboard --non-interactive --prompt "analytics dashboard with charts"

# Using shorthand flag
prism my-app -y --prompt "social media platform like Twitter"

# Auto-detects project type from requirements
prism store --yes --prompt "e-commerce site with Bitcoin payments"

Environment Variable Automation

# Set requirements via environment
PRISM_AI_REQUIREMENTS="monitoring dashboard" prism metrics-app --non-interactive

# Combine with preset selection
PRISM_AUTO_PRESET=social prism social-app -y

Scripted Usage

# In your build script
echo "dashboard" | prism --prompt "real-time monitoring dashboard"

# In GitHub Actions
- name: Create project
  run: |
    bunx init-prism@latest app --non-interactive \
      --prompt "${{ inputs.requirements }}"

Features in Non-Interactive Mode

• ✅ No prompts or user input required
• ✅ Automatic preset selection based on requirements
• ✅ AI generation enabled by default
• ✅ Clean output (no ASCII banners)
• ✅ Exit codes for success/failure
• ✅ Works in CI/CD environments

🏗️ Preset Starting Points (Or Just Describe Your Idea!)

| Preset | What You Can Say | What You Get | |--------|------------------|---------------| | auth | "I need login functionality" | Bitcoin auth, encrypted backups, user management | | social | "Like Twitter but..." | Posts, likes, follows, profiles, feeds | | ecommerce | "A marketplace for..." | Listings, payments, storefront, orders | | full-stack | "An app with database" | Auth + API + Database + Admin panel | | custom | "I want..." | AI figures out exactly what you need |

Remember: You don't need to pick a preset. Just describe your idea and prism will figure out the best combination of components.

🔧 Configuration

Projects are configured through interactive prompts with sensible defaults:

• Testing: Bun test setup (optional)
• Linting: Biome configuration (recommended)
• Authentication: BigBlocks with storage backend selection
• UI Components: Framework selection with dependency management
• Database: ORM choice with connection setup

🛡️ Why Developers Love Prism

It Just Works™

• AI handles the tricky parts - Webpack configs, module resolution, environment setup
• Build verification - Won't finish until your project builds successfully
• Smart error recovery - Automatically fixes common issues
• Best practices built-in - Security, performance, and code quality by default

Forgiving & Flexible

• Understands typos - "bicoin auth" → Bitcoin authentication ✓
• Clarifies ambiguity - Asks questions instead of guessing wrong
• Iterative refinement - Keep adding features through conversation
• No "correct" way - Your natural language is the interface

Production-Ready Output

• TypeScript strict mode - Type-safe from the start
• Modern stack - Next.js 15, Bun, latest packages
• Security first - No vulnerable dependencies
• Optimized builds - Fast development and production

📄 Prompt Files (NEW!)

Save and share your project templates as prompt files:

Create a Prompt File

---
name: Bitcoin Social Media Platform
description: Twitter-like platform with Bitcoin tipping
tags: [social, bitcoin, tipping]
author: YourName
version: 1.0
bigblocksHints: [social, wallet, profile]
---

Create a social media platform with Bitcoin integration:

Features:
- User authentication with Bitcoin wallets
- Create posts with media support
- Bitcoin tipping for posts
- Real-time feed updates

Technical Requirements:
- Next.js 15 with App Router
- BigBlocks components
- Mobile responsive
- Fast page loads

Use Prompt Files

# Load from file
prism my-app --prompt ./prompts/social-media.prompt

# Short syntax
prism my-app -p ./templates/marketplace.md

# In CI/CD
prism build-$VERSION --prompt ./company-template.prompt -y

Share Templates

• Commit prompt files to your repo
• Share successful app recipes with your team
• Build a library of proven templates
• Version control your project specifications

🚀 Parallel Generation & Visual Comparison (NEW!)

Generate multiple variants simultaneously and compare them visually:

Generate 3 Variants at Once

# Interactive mode
prism parallel my-app

# From a prompt file (auto-generates 3 strategies)
prism parallel social-platform
> Choose: Load from prompt file
> Select: ./prompts/social-media.prompt

# Creates:
# 1. Conservative variant (minimal, stable)
# 2. Balanced variant (modern, practical)  
# 3. Creative variant (innovative, experimental)

Visual Comparison Interface

• Split-screen preview of all 3 running apps
• Live reload as changes are made
• One-click selection of the best variant
• Branch isolation - each on its own git branch
• Side-by-side testing in real browsers

Use Cases

• A/B/C Testing - Compare different approaches
• Risk Mitigation - See conservative vs creative
• Team Reviews - Show options to stakeholders
• Learning - Understand different implementations

🧠 BigBlocks Component Intelligence (NEW!)

Prism now intelligently selects from 96 BigBlocks components:

How It Works

$ prism
> "I want a social app with Bitcoin payments"

🤖 Analyzing... detected social + wallet features
📦 Selecting 24 components from 96 available:
  ✓ SocialFeed, PostCard, LikeButton
  ✓ WalletOverview, SendBSVButton
  ✓ LoginForm, ProfileManager
  ... optimized for your specific needs

Component Categories (v0.0.11)

• Authentication (6 components) - Bitcoin login, no passwords
• Social (9 components) - Posts, likes, follows, messaging
• Wallet (4 components) - Send/receive BSV, balances
• Marketplace (3 components) - Buy/sell with Bitcoin
• Profile (8 components) - User management, BAP identity
• Backup (8 components) - Encrypted recovery systems
• UI Components (16 components) - Modals, avatars, QR codes, NEW: drag-drop zones
• Developer Tools (4 components) - Crypto utilities
• Plus 38 more specialized components with responsive design!

Benefits

• 60-80% smaller bundles - Only includes what you need
• Faster builds - Less code to process
• Cleaner code - Organized imports by category
• Smart defaults - AI picks optimal components

📦 Automated Type Publishing (NEW!)

For library projects and complex applications, prism automatically sets up a sophisticated type publishing system:

When It's Enabled

• All library projects - Essential for reusable packages
• Complex web projects - With 3+ plugins or Bitcoin integration
• API projects - Headless projects with multiple plugins

What You Get

my-awesome-lib/
├── packages/types/        # Separate NPM package for types
├── scripts/              # Automated publishing scripts
│   ├── sync-types.sh    # Sync from main project
│   ├── bump-version.sh  # Smart version management
│   └── publish-types.sh # One-command publishing
└── .github/workflows/    # Auto-publish on commits

Features

• 🤖 CI/CD Integration - Auto-publishes on main branch commits
• 📈 Smart Versioning - Automatic patch/minor/major bumps
• 🔄 Type Synchronization - Keeps types in sync with code
• 📚 Documentation - Auto-generated type docs
• 🚀 Zero Config - Works out of the box

Usage Example

# Create a library with type publishing
prism new bitcoin-sdk --type library

# Your types are automatically published as:
# npm install @bitcoin-sdk/types

# Other projects can use:
import type { Transaction, Wallet } from '@bitcoin-sdk/types';

🎪 Try These Ideas!

Just type prism and describe any of these:

• "Twitter but users own their data" → Decentralized social platform
• "Etsy for digital downloads" → NFT marketplace with storefronts
• "Instagram for developers" → Code snippet sharing with social features
• "OnlyFans but on Bitcoin" → Content monetization platform
• "Reddit with micropayments" → Forum where upvotes cost satoshis
• "LinkedIn but verifiable" → Professional network with on-chain credentials
• "Pinterest for NFTs" → Visual NFT discovery and collection platform
• "Uber for anything" → P2P marketplace with escrow payments

Or just describe your own idea - the weirder, the better! Prism loves a challenge.

🤝 Contributing

We welcome contributions! The plugin registry system makes it easy to add new integrations:

1. Add to Registry - Update src/plugins/registry.json
2. Create Plugin - Implement in src/plugins/[category]/[name]/
3. Test Integration - Verify with existing project types
4. Submit PR - Include documentation and examples

Plugin Structure

src/plugins/category/plugin-name/
├── plugin.ts          # Plugin configuration
├── apply-templates.ts # Setup automation
└── templates/         # Code templates

📝 Examples

Create Bitcoin Social App

$ prism next social-app

┌   Create Next.js App - Quick Mode 
│
◆  Choose a preset:
│  ○ Minimal 
│  ○ With Authentication
│  ○ Full Stack
│  ○ E-commerce  
│  ● Social Platform  ← Select this
│  ○ Custom
└

🎉 Building your social platform with:
✅ Bitcoin authentication & user profiles
✅ Posts, likes, and social interactions  
✅ User feeds and discovery features
✅ BigBlocks social components
[Complete social app ready in 30 seconds]

Add Authentication to Existing Project

cd my-existing-project
prism plugins show bigblocks  # Review features
# Copy integration code from plugin details

Browse UI Components

prism plugins search ui
prism plugins show shadcn
prism plugins show bigblocks

🚀 Roadmap

• Remote Registry - GitHub-based plugin distribution
• Component Marketplace - Community plugin submissions
• AI-Powered Setup - Intelligent configuration suggestions
• Template Variations - Multiple implementation approaches
• Plugin CLI Tools - Streamlined plugin development

📄 License

MIT © [init-prism contributors]

✨ Stop configuring. Start creating. Let AI handle the boring parts.

Built with ❤️ for developers who'd rather be building cool stuff.