npm package: @lens.kamdem/saas-creator
Description: Build production-ready SaaS applications using comprehensive design system specifications
Author: Your Name
Latest version: 1.0.0

# SaaS Creation Skill

Build production-ready SaaS applications using comprehensive design system specifications.

## Overview

This skill generates complete, production-ready SaaS applications with all the features needed for a modern cloud-based software product. It leverages 28+ design system specifications covering everything from authentication to deployment.

## Features

- **Backend Generation**: FastAPI with Python, SQLAlchemy, PostgreSQL
- **Frontend Generation**: React 18 + TypeScript, Tailwind CSS
- **Authentication**: JWT, OAuth, MFA support
- **Multi-tenancy**: Tenant isolation, resolution, settings
- **Billing**: Stripe integration, subscriptions, quotas
- **Feature Flags**: Toggle system with rules engine
- **Webhooks**: Delivery with retry and idempotence
- **Audit Logging**: Immutable, searchable audit trails
- **Rate Limiting**: IP/user/plan based limits
- **Background Jobs**: Celery + RabbitMQ integration
- **Import/Export**: CSV, JSON, Excel support
- **Notifications**: Multi-channel (email, push, SMS)
- **API Documentation**: OpenAPI, Swagger, ReDoc
- **Health Checks**: Liveness, readiness, startup probes

## Installation

### Claude Code

```bash
git clone <repo-url> ~/.claude/skills/saas-creation-skill
```

### Cursor

```bash
git clone <repo-url> .cursor/rules/saas-creation-skill
```

### VS Code Copilot

```bash
git clone <repo-url> .github/skills/saas-creation-skill
```

### Windsurf

```bash
git clone <repo-url> .windsurf/rules/saas-creation-skill
```

### OpenCode

```bash
git clone <repo-url> ~/.config/opencode/skills/saas-creation-skill
```

### Universal (Codex, Gemini CLI, Kiro, Antigravity)

```bash
git clone <repo-url> ~/.agents/skills/saas-creation-skill
```

## Usage

### Basic SaaS with Auth + Billing

```
/saas-creation-skill Create a SaaS with user authentication and Stripe subscription billing
```

### Multi-tenant CRM

```
/saas-creation-skill Build a multi-tenant CRM with role-based access and analytics
```

### Full-featured Platform

```
/saas-creation-skill Generate a complete SaaS platform with all design systems
```

### Custom Features

```
/saas-creation-skill Create a project management app with auth, billing, webhooks, and audit logging
```

## Command Line Usage

You can also generate applications from the command line:

```bash
# Install the skill first
cd saas-creation-skill
chmod +x install.sh
./install.sh

# Generate a SaaS application
python3 scripts/generator.py my-saas-app --features auth billing multitenancy

# Generate with specific features
python3 scripts/generator.py crm-app \
  --type crm \
  --features auth billing multitenancy webhooks audit
```

## Available Features

| Feature | Description |
|---------|-------------|
| auth | User authentication with JWT, OAuth, MFA |
| billing | Stripe subscription billing |
| multitenancy | Multi-tenant architecture |
| webhooks | Webhook delivery system |
| audit | Audit logging |
| rate_limiting | Rate limiting |
| jobs | Background job processing |
| import_export | Data import/export |
| notifications | Multi-channel notifications |
| api_docs | API documentation |
| health_checks | Health check endpoints |
| frontend | React frontend |
| state | State management |
| forms | Form validation |
| i18n | Internationalization |
| theming | Dynamic theming |
| onboarding | User onboarding |
| analytics | Event tracking |
| ab_testing | A/B testing |
| performance | Performance monitoring |
| accessibility | WCAG accessibility |
| storybook | Component documentation |

## Generated Project Structure

```
my-saas-app/
├── backend/
│   ├── app/
│   │   ├── api/           # API routes
│   │   ├── core/          # Config, security
│   │   ├── models/        # SQLAlchemy models
│   │   ├── schemas/       # Pydantic schemas
│   │   ├── services/      # Business logic
│   │   └── utils/         # Utilities
│   ├── alembic/           # Migrations
│   ├── tests/             # Unit tests
│   ├── Dockerfile
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── components/    # React components
│   │   ├── pages/         # Page components
│   │   ├── hooks/         # Custom hooks
│   │   ├── services/      # API clients
│   │   ├── store/         # State management
│   │   ├── i18n/         # Translations
│   │   └── styles/        # CSS/Tailwind
│   ├── stories/           # Storybook
│   ├── Dockerfile
│   └── package.json
├── docker-compose.yml
├── kubernetes/
│   ├── backend/
│   ├── frontend/
│   └── database/
├── .github/
│   └── workflows/         # CI/CD
└── README.md
```

## Design Systems Included

This skill includes 28 production-ready design systems:

- **AUTH.md** - Authentication system
- **MULTI_TENANCY.md** - Multi-tenant architecture
- **USER_ACCESS_MANAGEMENT.md** - RBAC and permissions
- **BILLING_SUBSCRIPTION.md** - Stripe subscriptions
- **PAYMENTS.md** - Payment processing
- **FEATURE_FLAGS.md** - Feature toggle system
- **WEBHOOKS.md** - Webhook delivery
- **AUDIT_LOGGING.md** - Audit trails
- **RATE_LIMITING.md** - Rate limiting
- **BACKGROUND_JOBS_QUEUES.md** - Async jobs
- **IMPORT_EXPORT.md** - Data import/export
- **NOTIFICATION.md** - Notifications
- **API_DOC.md** - API documentation
- **HEALTH_CHECKS.md** - Health probes
- **FRONTEND_DESIGN_SYSTEM.md** - Component library
- **FRONTEND_ROUTING_AUTH.md** - Routing & auth
- **STATE_MANAGEMENT.md** - State management
- **FORM_VALIDATION.md** - Form validation
- **ONBOARDING.md** - User onboarding
- **PERSONALIZATION.md** - User preferences
- **THEMING_WHITE_LABEL.md** - Dynamic theming
- **INTERNATIONALIZATION.md** - i18n
- **ANALYTICS_TRACKING.md** - Event tracking
- **AB_TESTING.md** - A/B testing
- **PERFORMANCE_MONITORING.md** - Performance
- **ACCESSIBILITY.md** - WCAG compliance
- **COMPONENT_PLAYGROUND.md** - Storybook

## Quick Start

1. Install the skill
2. Invoke with `/saas-creation-skill` followed by your requirements
3. The skill will generate a complete SaaS application

## Development

### Requirements

- Python 3.11+
- Node.js 18+
- Docker and Docker Compose

### Local Development

```bash
# Clone the skill
git clone <repo-url> saas-creation-skill

# Generate an app
python3 scripts/generator.py my-app --features auth billing

# Start development
cd my-app
docker-compose up -d

# Access the app
# API: http://localhost:8000/docs
# Frontend: http://localhost:3000
```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

MIT