Template Marketplace | Bootspring Docs

The Bootspring Template Marketplace provides pre-built templates for common patterns, features, and integrations that you can install in seconds.

Overview#

Templates are packaged code patterns that include:

File structures - Organized source files
Dependencies - Required npm packages
Configuration - Pre-configured settings
Documentation - Usage instructions

Template Categories#

Category	Description
Starters	Complete project starter templates
Components	Reusable UI components
Features	Feature modules (auth, payments, etc.)
Workflows	Custom workflow definitions
Agents	Custom agent profiles
Skills	Code generation skills
Integrations	Third-party service integrations

Official Templates#

Starters#

Template	Description	Stack
`saas-starter`	Complete SaaS with auth, payments, dashboard	Next.js, Prisma, Stripe, Clerk
`api-starter`	REST API with auth and docs	Express, Prisma, Swagger

Features#

Template	Description	Stack
`auth-clerk`	Clerk authentication integration	Next.js, Clerk
`payments-stripe`	Stripe subscriptions and webhooks	Next.js, Stripe
`ai-chat`	Claude-powered chat interface	Next.js, Anthropic SDK

Using the Marketplace#

Browse Templates#

# List all templates
bootspring marketplace list

# Filter by category
bootspring marketplace list --category features

# Search templates
bootspring marketplace search "authentication"

View Template Details#

bootspring marketplace info auth-clerk

# Output:
# Template: auth-clerk
# Name: Clerk Authentication
# Category: feature
# Version: 1.0.0
# Author: bootspring (official)
#
# Description:
#   Complete Clerk auth integration with protected routes
#
# Files:
#   - src/middleware.ts
#   - src/app/sign-in/*
#   - src/app/sign-up/*
#   - src/components/auth/*
#
# Dependencies:
#   - @clerk/nextjs: ^4.0.0

Install Templates#

# Install a template
bootspring marketplace install auth-clerk

# Install with force (overwrite existing)
bootspring marketplace install auth-clerk --force

# Check installation status
bootspring marketplace installed

Update Templates#

# Check for updates
bootspring marketplace check-updates

# Update a specific template
bootspring marketplace update auth-clerk

# Update all templates
bootspring marketplace update-all

Uninstall Templates#

bootspring marketplace uninstall auth-clerk

API Usage#

const marketplace = require('bootspring/marketplace');

// List all templates
const templates = marketplace.listTemplates();

// Search templates
const results = marketplace.searchTemplates('authentication');

// Get template details
const template = marketplace.getTemplate('auth-clerk');

// Install template
const result = marketplace.installTemplate('auth-clerk');
// { success: true, files: 4, dependencies: 1 }

// Check if installed
const isInstalled = marketplace.isInstalled('auth-clerk');

// List installed templates
const installed = marketplace.listInstalled();

// Check for updates
const updates = marketplace.checkUpdates();

// Uninstall template
marketplace.uninstallTemplate('auth-clerk');

// Get marketplace stats
const stats = marketplace.getStats();
// { totalTemplates: 15, officialTemplates: 5, installedTemplates: 2 }

Template Structure#

What's in a Template#

template/
├── template.json       # Template metadata
├── files/              # Source files to install
│   ├── src/
│   │   ├── components/
│   │   └── lib/
│   └── prisma/
├── dependencies.json   # Required npm packages
└── README.md          # Usage instructions

Template Metadata#

{
  "id": "auth-clerk",
  "name": "Clerk Authentication",
  "description": "Complete Clerk auth integration",
  "category": "feature",
  "version": "1.0.0",
  "author": "bootspring",
  "official": true,
  "tags": ["auth", "clerk", "sso"],
  "stack": ["nextjs", "clerk"],
  "files": ["src/middleware.ts", "src/app/sign-in/*"],
  "dependencies": {
    "@clerk/nextjs": "^4.0.0"
  }
}

Publishing Templates#

Validate Before Publishing#

# Validate template structure
bootspring marketplace validate ./my-template

# Dry-run publish
bootspring marketplace publish ./my-template --dry-run

Publish (Coming Soon)#

# Publish to marketplace (requires authentication)
bootspring marketplace publish ./my-template

Template Requirements#

Unique ID - Lowercase with hyphens
Clear description - What it does and when to use it
Valid category - Must be a known category
Version number - Semantic versioning
Working files - All referenced files must exist

Best Practices#

When Installing Templates#

Review the files - Understand what will be installed
Check dependencies - Ensure compatibility with your project
Back up first - Especially when using --force
Read the README - Templates often have setup instructions

When Creating Templates#

Keep it focused - One feature per template
Document everything - Include clear usage instructions
Test thoroughly - Ensure it works in fresh projects
Use consistent naming - Follow existing conventions

Marketplace Statistics#

View current marketplace stats:

bootspring marketplace stats

# Output:
# Template Marketplace Statistics
# ─────────────────────────────────
# Total Templates: 15
# Official Templates: 5
# Installed Templates: 2
#
# By Category:
#   starters: 2
#   features: 5
#   components: 4
#   integrations: 4