@vocoweb/create-voco-app

v1.1.0

Published

4 months ago

Scaffold a Sovereign SaaS Next.js app with @vocoweb/* packages

Downloads

0High
0Medium
0Low

shyamolkonwar

cli nextjs saas vocoweb scaffold

create-voco-app

Scaffold a Sovereign SaaS Next.js application with all production-ready @vocoweb/* packages pre-installed.

What is VocoWeb?

VocoWeb is an AI-powered full-stack code generation platform. This CLI tool lets you scaffold production-ready SaaS applications with:

Authentication - Email, OAuth (Google, GitHub), MFA support
Payments - Stripe integration with subscription billing
Multi-tenancy - Organizations, roles, and permissions
GDPR Compliance - Cookie consent, data portability, erasure
Feature Flags - Plan-based feature gating
Usage Tracking - Usage-based pricing and quotas
Analytics - Privacy-first analytics
SEO - Auto-sitemaps, OpenGraph, blog support
And more...

Installation

# Using npx (recommended)
npx @vocoweb/create-voco-app my-saas

# Or install globally
npm install -g @vocoweb/create-voco-app
create-voco-app my-saas

Usage

Interactive Mode

npx @vocoweb/create-voco-app

This will prompt you for:

Project name
Template selection
Data region (EU, US, Singapore)
Billing provider
VocoWeb API key (or create account)

Non-Interactive Mode

npx @vocoweb/create-voco-app my-saas --template saas --region eu-central-1 --billing stripe

Options

| Option | Alias | Description | Default | |--------|-------|-------------|---------| | --template | -t | Template to use (saas, landing) | saas | | --region | -r | Data region (eu-central-1, us-east-1, ap-southeast-1) | eu-central-1 | | --billing | -b | Billing provider (stripe, paddle) | stripe | | --api-key | -k | VocoWeb API key | - | | --yes | -y | Skip prompts, use defaults | false |

Templates

SaaS Template (`--template saas`)

Full-featured SaaS application with:

Authentication (login, signup, OAuth)
Dashboard with sidebar
Organization/team management
Subscription billing
GDPR compliance
Feature flags
Usage tracking

Landing Template (`--template landing`)

Simple landing page with:

Hero section
Features grid
Pricing cards
Footer
SEO optimization
GDPR cookie consent

After Creation

cd my-saas
npm install
npm run dev

Your app will be available at http://localhost:3000

Eject Mechanism

Want to remove VocoWeb proprietary code? Use the eject command:

cd my-saas
npx @vocoweb/create-voco-app eject

This will:

Remove all @vocoweb/* imports
Replace with standard Supabase/Stripe code
Generate boilerplate for your project

This ensures users can "eject" and own their code - not locked in.

Environment Variables

After scaffolding, update .env.local with your credentials:

# VocoWeb
VOCO_API_KEY=your_api_key
VOCO_PROJECT_ID=your_project_id

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_key

# Stripe
STRIPE_SECRET_KEY=sk_test_xxx
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_xxx
STRIPE_WEBHOOK_SECRET=whsec_xxx

Packages Included

This template includes all 22 @vocoweb/* packages:

@vocoweb/kernel - Auth, payments, compliance
@vocoweb/tenant - Multi-tenancy, RBAC
@vocoweb/consent - GDPR cookie consent
@vocoweb/erasure - Right to be forgotten
@vocoweb/portability - Data portability
@vocoweb/residency - Data sovereignty
@vocoweb/features - Feature flags
@vocoweb/meter - Usage tracking
@vocoweb/notify - Notifications
@vocoweb/mail - Email engine
@vocoweb/invoice - VAT invoices
@vocoweb/admin - Admin panel
@vocoweb/analytics - Privacy analytics
@vocoweb/seo - SEO optimization
@vocoweb/geo - AI/LLM SEO
@vocoweb/viral - Referral system
@vocoweb/a11y-guard - Accessibility
@vocoweb/errors - Error handling
@vocoweb/support - Support widget
@vocoweb/local - Offline dev
@vocoweb/codegen - TypeScript from DB
@vocoweb/sdk - Unified SDK

Documentation

License

MIT