Skip to content

BackApps-ai/claude-code-plugin

Repository files navigation

BackApps for Claude Code

Complete backend-as-a-service integration for Claude Code. Production-ready databases, APIs, and SDKs with zero infrastructure—entirely through slash commands.

Version Claude Code License Node Tests


What is BackApps?

BackApps = Complete Backend in Minutes

Building backends is slow. Setting up databases, writing APIs, managing infrastructure—it takes hours or days before you can focus on your actual product.

BackApps changes that:

  • Live database (Turso Cloud)
  • REST API (auto-generated)
  • Client SDK (12+ languages)

Zero infrastructure. Zero boilerplate. Just ship.


Quick Start Examples

See BackApps in action with complete applications across different languages and use cases:

Python: Chat Application with LLM

Please create an app where users can create and open chats, each chat is made
of transcript and users can send a message to LLM and receive a response.
In Python, with UI, no backend/database required. Use /backapps:-init- to
generate all the backend/backend API required.

What this does:

  1. Authenticates with BackApps (opens browser, one-time sign-in)
  2. Detects your Chat and Message models from your Python code
  3. Provisions a live database with tables and REST API endpoints
  4. Generates a Python client SDK for easy API access
  5. Creates a complete working application with UI

Result: A production-ready chat application with LLM integration, persistent storage, and zero infrastructure setup.

TypeScript: Todo List with Categories and Tags

Build a todo list app in TypeScript with React where users can organize tasks
with categories, tags, and due dates. Include filtering and search functionality.
With UI, no backend/database required, use /backapps:-init- to generate all
the backend/API required.

Result: A type-safe task management application with rich filtering capabilities, built with React and TypeScript, backed by a live database and auto-generated REST API.

Go: Real-time Analytics Dashboard

Create a real-time analytics dashboard in Go that tracks page views, user sessions,
and conversion events. Display metrics with charts and time-series graphs.
With UI, no backend/database required, use /backapps:-init- to generate all
the backend/API required.

Result: A high-performance analytics platform with interactive visualizations, leveraging Go's concurrency for real-time data processing with persistent storage.

Ruby: Blog Platform with Comments

Build a blog platform in Ruby on Rails where authors can write posts with markdown
support, readers can leave comments, and admins can moderate content.
With UI, no backend/database required, use /backapps:-init- to generate all
the backend/API required.

Result: A full-featured content management system with user authentication, markdown rendering, and comment moderation, all powered by Rails conventions and BackApps infrastructure.

Rust: Expense Tracker with Budgets

Create an expense tracker in Rust with Actix-web where users can log expenses,
set monthly budgets by category, and view spending trends over time.
With UI, no backend/database required, use /backapps:-init- to generate all
the backend/API required.

Result: A blazingly fast personal finance application with category-based budgeting and trend analysis, built with Rust's safety guarantees and backed by production-ready APIs.


Installation & Setup

Get started in three steps:

1. Install Plugin

Prerequisites: Claude Code v2.0.28+ (for Skills, Plan subagent, and subagent resumption)

/plugin marketplace add https://github.com/BackApps-ai/claude-code-plugin
/plugin install backapps@BackApps-ai

Installation takes 1-2 minutes. Wait for success message before proceeding.

2. Authenticate

/backapps:login

Opens your browser for one-time authentication. Credentials stored securely.

3. Initialize Backend

/backapps:-init-

This automated workflow takes 2-15 minutes (depending on project size):

  1. Creates/selects your BackApps app
  2. Analyzes code for model definitions
  3. Provisions database tables and API endpoints
  4. Generates SDK client code
  5. Verifies everything is working

Done! You now have a live database, REST API, and client SDK.


Getting Help

BackApps has comprehensive built-in help for every command, tool, and agent.

/backapps:help                    # General help index
/backapps:help <command>          # Command help (e.g., login, models)
/backapps:help tools              # List all 19 MCP tools
/backapps:help tools:<tool>       # Specific tool help
/backapps:help agents             # List all 5 agents
/backapps:help agents:<agent>     # Specific agent help

External Resources:


What You Get

8 Powerful Commands

Command Description
/backapps:login Authenticate with BackApps
/backapps:-init- Complete setup workflow
/backapps:apps Manage applications
/backapps:models Analyze code, provision schemas
/backapps:data CRUD operations on data
/backapps:openapi View/regenerate API specs
/backapps:client Generate SDKs in 12+ languages
/backapps:logout Sign out

19 Auto-Approved MCP Tools

Zero approval prompts. Claude seamlessly uses tools for:

  • Authentication and token management
  • App creation and management
  • Model definition and updates
  • CRUD operations and queries
  • OpenAPI spec generation

5 Specialized Agents

Sub-agents that handle complex tasks:

  • backapps-provisioner: Extracts models, generates schemas
  • backapps-sdk-generator: Generates SDK clients for 12+ languages
  • backapps-api-integrator: Builds integration tests
  • backapps-data-seeder: Generates realistic test data
  • backapps-schema-validator: Validates schema changes

Supported Technologies

Languages: TypeScript, JavaScript, Python, Go, Java, Ruby, Elixir, Rust, PHP, C#, Kotlin, Swift

Frameworks: Next.js, Express, NestJS, FastAPI, Django, Rails, Phoenix, Actix, Laravel, ASP.NET, Spring Boot


Important: No Standalone CLI

BackApps does NOT have a backapps command-line tool. All operations happen through:

  1. Slash Commands in Claude Code: /backapps:login, /backapps:models provision
  2. MCP Tools: Used internally by Claude when appropriate
# WRONG - These don't exist
backapps login
backapps apps list

# CORRECT - Use in Claude Code
/backapps:login
/backapps:apps list

Production Ready

Security

  • OAuth 2.0 authentication with auto-refresh tokens
  • Encrypted at rest and in transit
  • GDPR and SOC 2 compliant

Performance

  • Edge-distributed databases (Turso Cloud)
  • Automatic indexing and smart caching
  • 99.9% uptime SLA (paid plans)

Quality

  • 91 passing tests
  • Graceful error handling
  • Audit logging for destructive operations

FAQ

Is BackApps free? Yes! Free tier includes 3 apps, 10GB storage, 100k API requests/month.

Do I need to manage servers? No. Fully managed—no Docker, deployment, or infrastructure.

Can I use this in production? Yes! Production-ready with 99.9% uptime SLA (paid plans) and enterprise support.

What about data privacy? Data encrypted at rest and in transit. GDPR compliant. Privacy Policy

What if I outgrow BackApps? Export data anytime using /backapps:data list <Model> or use OpenAPI spec to build your own backend.


Troubleshooting

Plugin not recognized

Problem: /backapps:* commands don't work

Solution:

  1. Verify installation: /plugin list
  2. Restart Claude Code completely
  3. Reinstall: /plugin uninstall backapps then install again

Authentication errors

Problem: "Authentication required" after login

Solution:

/backapps:logout
/backapps:login

For more help: Use /backapps:help or visit the Troubleshooting Guide


Roadmap

This roadmap outlines planned features and improvements. Dates are estimates and subject to change based on feedback and priorities.

v1.4.0 (Current)

Released: October 2025

Core features:

  • 19 auto-approved MCP tools for seamless integration
  • 8 powerful commands with comprehensive help system
  • 5 specialized agents (provisioner, SDK generator, API integrator, data seeder, schema validator)
  • Multi-language SDK generation (12 languages supported)
  • Framework integration for major frameworks
  • Production-ready OAuth 2.0 authentication with auto-refresh tokens
  • Comprehensive help system (/backapps:help)

v1.5.0 (Current Release)

Released: October 2025

Focus: Natural Language Support, Safety, and Performance

Skills System

  • backapps-quickstart Skill: Natural language support for "I need a backend"
  • Complete workflow orchestration (auth → models → provision → SDK)
  • Interactive progress tracking with TodoWrite
  • Smart error handling with fallback options

Interactive Safety Features

  • Confirmation prompts for all destructive operations
  • App deletion: Shows what will be deleted before confirming
  • Force provision: Explicit data loss warning with model counts
  • Data seeding: Interactive count selection (10/50/100/Custom)

Performance Optimizations

  • Explore subagent integration: 10-100x faster model detection
  • Optimized for large codebases and monorepos
  • Smart fallback to traditional glob search
  • Reduced token consumption

Advanced Planning

  • Plan subagent integration in -init- command
  • Strategic initialization for complex scenarios
  • Multi-app and schema conflict detection
  • Risk assessment and mitigation planning

Subagent Resumption

  • Schema validator supports session tracking
  • Iterative validation and fixing workflow
  • Progress tracking across validation runs
  • Issue resolution verification

Intelligent Model Selection

  • Dynamic Haiku/Sonnet selection per agent
  • Cost optimization for simple tasks (Haiku)
  • Quality optimization for complex tasks (Sonnet)
  • Task-specific model guidance for all 5 agents

Requirements

  • Requires Claude Code v2.0.28+ (for Skills, Plan subagent, AskUserQuestion, and subagent resumption)

v1.6.0 (Q2 2026)

Focus: Team Collaboration and Monitoring

Team Features

  • Multi-user support: Invite team members to projects
  • Role-based access: Admin, developer, and viewer roles
  • Audit logs: Track all changes and API calls
  • Shared environments: Dev, staging, production separation

Monitoring & Analytics

  • Usage dashboards: API calls, data storage, performance metrics
  • Error tracking: Detailed error logs and stack traces
  • Performance insights: Slow query detection and optimization tips
  • Cost monitoring: Track usage against plan limits

Developer Tools

  • Local development mode: Test without hitting production
  • Seed data management: Reusable test data sets
  • API testing tools: Built-in request/response testing
  • Mock mode: Simulate API responses for offline development

v2.0.0 (Q3 2026)

Focus: Real-time and Advanced Features

Real-time Data

  • WebSocket support: Live data updates
  • Subscriptions: React to data changes in real-time
  • Pub/Sub: Event-driven architecture
  • Presence: Track online users and activity

Security & Access Control

  • Row-level security: Fine-grained data access rules
  • API key management: Create and rotate API keys
  • IP allowlisting: Restrict access by IP address
  • Custom authentication: Bring your own auth provider

Extensibility

  • Custom functions: Deploy serverless functions
  • Webhooks: React to database events
  • Triggers: Automated workflows on data changes
  • Custom endpoints: Build specialized API endpoints

Self-hosting

  • Docker support: Run BackApps on your infrastructure
  • Kubernetes manifests: Enterprise deployment options
  • Database bring-your-own: Connect to existing databases
  • Air-gapped mode: Fully offline operation

v2.1.0 and Beyond (2027+)

Advanced Database Features

  • Full-text search: Advanced search capabilities
  • Geospatial queries: Location-based data
  • Time-series data: Optimized for temporal data
  • Graph relationships: Complex relationship modeling

AI/ML Integration

  • Vector embeddings: Store and search vector data
  • Semantic search: AI-powered content discovery
  • Auto-generated APIs: ML-powered API suggestions
  • Smart data modeling: AI-assisted schema design

Enterprise Features

  • SSO integration: SAML, OAuth, LDAP support
  • Custom SLAs: Guaranteed uptime and support
  • Dedicated instances: Isolated infrastructure
  • White-label option: Brand as your own

Developer Experience

  • Visual schema editor: GUI for database design
  • API playground: Interactive API testing
  • Code generation: Boilerplate generation for common patterns
  • Migration from other services: Import from Firebase, Supabase, etc.

Feature Voting

Want to influence the roadmap? Here's how:

  1. Vote on existing features: Comment on roadmap issues with thumbs up
  2. Suggest new features: Open a feature request issue
  3. Sponsor development: Contact us about sponsoring specific features
  4. Join beta testing: Early access to upcoming features

Release Schedule

  • Minor versions (1.x.0): Every 2-3 months
  • Patch versions (1.x.y): As needed for bugs and security
  • Major versions (2.0.0): Annually

Stay Updated

  • GitHub Releases: Watch the repository for release notifications

Contributing

We welcome contributions! Here's how you can help make BackApps better.

Ways to Contribute

1. Report Bugs

Found a bug? Create an issue with:

  • Clear description of the problem
  • Steps to reproduce
  • Expected vs actual behavior
  • Environment details (OS, Claude Code version, plugin version)

2. Request Features

Have an idea? Open a feature request with:

  • Your use case and problem statement
  • Proposed solution (if you have one)
  • Why this would benefit other users

3. Improve Documentation

Help make docs better:

  • Fix typos or unclear explanations
  • Add examples and use cases
  • Improve code samples
  • Translate to other languages

4. Write Code

Want to contribute code? Here's the process:

Setup:

# Clone the repository
git clone https://github.com/BackApps-ai/claude-code-plugin.git
cd claude-code-plugin

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

Development:

  1. Pick an issue labeled good first issue or create one
  2. Fork the repository
  3. Create a feature branch: git checkout -b feature/your-feature
  4. Make your changes with tests
  5. Run npm test to ensure all tests pass
  6. Run npm run lint to check code style
  7. Commit with clear messages
  8. Push and create a pull request

Pull Request Guidelines:

  • Reference the issue number
  • Include tests for new features
  • Update documentation if needed
  • Follow existing code style
  • Keep changes focused (one feature per PR)

5. Share Examples

Built something cool? Share it:

  • Create a blog post or tutorial
  • Add to our examples directory
  • Share on social media with #BackApps
  • Present at meetups or conferences

Development Guidelines

Code Style

  • Use TypeScript for all new code
  • Follow existing patterns and conventions
  • Write self-documenting code with clear names
  • Add JSDoc comments for public APIs
  • Keep functions small and focused

Testing

  • Write unit tests for new features
  • Update integration tests if needed
  • Aim for 80%+ code coverage
  • Test edge cases and error conditions

Documentation

  • Update README.md for user-facing changes
  • Add inline comments for complex logic
  • Update CHANGELOG.md with your changes
  • Document breaking changes clearly

Questions?

Thank you for contributing to BackApps! Every contribution, no matter how small, helps make the plugin better for everyone.


License

MIT License


Code of Conduct

Be respectful and inclusive:

  • Use welcoming language
  • Respect different viewpoints
  • Accept constructive criticism
  • Focus on what's best for the community

Acknowledgments

Built with:


Ready to Build?

/backapps:login
/backapps:-init-

That's all it takes. Install the plugin, authenticate, and start building.

Zero infrastructure. Zero boilerplate. Just ship.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •