PocketBase Starter Kit

A powerful, production-ready full-stack starter kit that combines SvelteKit and PocketBase for rapid SaaS development.

✨ Features

• 🚀 Full-Stack Solution: SvelteKit frontend + PocketBase backend
• 🔐 Modern Authentication: WebAuthn passkeys with progressive login flow
• 💳 Payment Integration: Complete Stripe subscription management
• 📁 File Uploads: TUS resumable uploads with image thumbnails
• 🌍 Internationalization: Multi-language support (English/French)
• 🧪 Testing Suite: Vitest unit tests + Playwright E2E tests
• 🎨 Modern UI: shadcn-svelte components with dark/light themes
• ⚡ Performance: Static site generation with optimal loading
• 🔒 Type Safety: Full TypeScript coverage
• 🛠️ Developer Experience: Pre-commit hooks, Storybook, linting

🚀 Quick Start

# Clone the repository
git clone <your-repo-url>
cd pb_starter

# Complete setup (dependencies + git hooks + build)
make setup

# Start development
make dev

The setup command will:

• Install all dependencies (frontend + backend)
• Set up git pre-commit hooks to run tests before commits
• Build the PocketBase backend
• Prepare everything for development

📖 Development

Available Commands

make help          # Show all available commands
make dev           # Start both backend and frontend
make test          # Run all tests
make build         # Build for production
make clean         # Clean build artifacts

Manual Setup (Alternative)

If you prefer manual setup:

# Install dependencies
cd sk && npm install
cd ../pb && go mod tidy

# Build backend
cd pb && go build

# Start development
make dev

🏗️ Architecture

• Frontend: SvelteKit 5 with runes, TypeScript, Tailwind CSS
• Backend: PocketBase (Go) with SQLite database
• Authentication: WebAuthn passkeys + traditional auth
• Payments: Stripe integration with webhooks
• File Storage: Built-in with TUS uploads
• Testing: Vitest + Playwright
• Deployment: Static files served by PocketBase

📱 Tech Stack

Frontend

• SvelteKit 5 with runes
• TypeScript
• Tailwind CSS
• shadcn-svelte components
• Paraglide i18n
• GSAP animations

Backend

• PocketBase (Go framework)
• SQLite database
• WebAuthn implementation
• Stripe webhooks
• TUS upload handler

Developer Tools

• Vitest (unit testing)
• Playwright (E2E testing)
• Storybook (component development)
• ESLint + Prettier
• Pre-commit hooks

🔧 Configuration

Environment variables are stored in pb/.env:

STRIPE_SECRET_KEY=sk_test_...
STRIPE_SECRET_WHSEC=whsec_...
STRIPE_CANCEL_URL=http://localhost:5174/pricing?canceled=true
STRIPE_SUCCESS_URL=http://localhost:5174/billing?success=true
HOST=http://localhost:8090
DEVELOPMENT=true

🧪 Testing

The project includes comprehensive testing with automatic pre-commit validation:

make test          # Run all tests
make test-unit     # Unit tests only
make test-e2e      # E2E tests only

Tests automatically run before git commits to ensure code quality.

📚 Documentation

Detailed project instructions are in CLAUDE.md for AI-assisted development.

🌐 Deployment

1. Build the frontend: cd sk && npm run build
2. Build the backend: cd pb && go build
3. Deploy the PocketBase binary with the sk/build directory
4. Configure environment variables for production

🔗 Key Endpoints

• Frontend: http://localhost:5174
• Backend API: http://localhost:8090
• Admin Dashboard: http://localhost:8090/_/
• Storybook: http://localhost:6006

📄 License

[Your License Here]