Frequently Asked Questions¶

Common questions and solutions for all tiers.

Tiers & Features¶

Which tier should I choose?¶

Hustler (€19): Learning the stack, building basic MVP without payments
Top G (€59): Ready to monetize with Stripe, need admin/analytics
AI Velocity (€79): Want AI-assisted development with Cursor/Claude Code

Detailed tier comparison

What's the difference between Top G and AI Velocity?¶

Top G: All production features (payments, admin, analytics, integrations, RBAC)
AI Velocity: Everything in Top G + 18 Cursor rules + Claude Code package

Top G = Full features
AI Velocity = Full features + AI development tools

AI Development documentation

Can I upgrade between tiers?¶

Tiers are separate zip files. To upgrade:

Purchase higher tier
Download new zip
Migrate database (schemas are compatible)
Copy your custom code

Database models are compatible between tiers.

What comes in each tier?¶

Hustler:

Auth (JWT + Google OAuth)
Articles (unlimited)
User profiles
Dark mode
Basic dashboard

Top G (all Hustler features +):

Stripe payments (subscriptions + one-time)
Admin panel (user/payment management)
Analytics system (4 tiers)
Integrations (webhook templates)
RBAC system (plan-based permissions)

AI Velocity (all Top G features +):

18 Cursor rules (<500 lines each)
CLAUDE.md context file
6 Claude Code slash commands
AI workflow guides

Feature details

Setup & Installation¶

How do I install?¶

Bash
# 1. Extract zip
unzip your-tier-boilerplate.zip
cd your-tier-boilerplate

# 2. Automated setup
task full-setup

# 3. Start development
task run-backend    # Terminal 1
task run-frontend   # Terminal 2

Full installation guide

What are prerequisites?¶

Required:

Python 3.11+
Poetry
Node.js 18+
Docker
Task

Installation guide - Prerequisites

How do I configure environment?¶

Bash
# Copy example
cp local.env.example local.env

# Edit with your values
# Minimum required: secret_key, database settings

# Top G+ also needs:
# - Stripe keys
# - Google OAuth (optional)
# - Email service

Configuration guide

Tier-Specific Setup¶

How do I set up Stripe payments? (Top G+)¶

Bash
# 1. Get Stripe keys from stripe.com
# 2. Add to local.env
STRIPE_SECRET_KEY=sk_test_...
STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# 3. Initialize products
task payments:setup

# 4. Test with card: 4242 4242 4242 4242

Stripe payments guide

How do I access admin panel? (Top G+)¶

Bash
# 1. Create superuser
task db:user-create -- --email [email protected] --password admin123

# 2. Start backend
task run-backend

# 3. Visit admin panel
# http://localhost:8020/admin/

Admin panel guide

How do I use Cursor rules? (AI Velocity)¶

Open project in Cursor
Rules load automatically
Start coding - Cursor knows patterns

Type @ to reference specific rules.

Cursor setup guide

How do I use Claude Code? (AI Velocity)¶

Bash
# Install Claude CLI
curl -fsSL https://claude.ai/install.sh | sh

# Start Claude
cd your-project
claude

# Use custom commands
/new-api-endpoint GET /api/example
/new-component ExampleCard

Claude Code guide

Database¶

Database won't start¶

Bash
# Check if running
docker ps | grep postgres

# Restart
docker-compose down
docker-compose up -d

# Wait 10 seconds
task db:migrate-up

How do I create migrations?¶

Bash
# 1. Update model in app/models.py
# 2. Create migration
task db:migrate-create -- "description"

# 3. Review in migrations/versions/
# 4. Apply
task db:migrate-up

Database guide

How do I reset database?¶

Bash
# WARNING: Deletes all data
docker-compose down -v
docker-compose up -d
task db:migrate-up

Frontend¶

Frontend won't connect to backend¶

Check CORS configuration:

Python
# main.py
allow_origins=[
    "http://localhost:5173",  # Vite dev server
]

API client out of sync¶

Bash
1 2	`# ALWAYS run after backend API changes task frontend:generate-client`

Module not found errors¶

Bash
cd frontend
rm -rf node_modules package-lock.json
npm install
npm run dev

Development¶

How do I add new API endpoint?¶

Bash
# 1. Create schemas in app/schemas/
# 2. Add service method in app/services/
# 3. Create controller in app/controllers/
# 4. Generate client
task frontend:generate-client
# 5. Create React hook in frontend/src/hooks/api/

Development guide

Port already in use¶

Bash
# Kill backend (port 8020)
lsof -ti:8020 | xargs kill -9

# Kill frontend (port 5173)
lsof -ti:5173 | xargs kill -9

Payments (Top G+)¶

Stripe test cards¶

Success: 4242 4242 4242 4242
Decline: 4000 0000 0000 0002
3D Secure: 4000 0027 6000 3184

More test cards

Webhooks not working locally¶

Bash
# Use Stripe CLI for local testing
stripe listen --forward-to localhost:8020/api/payments/webhook

# Verify webhook secret in local.env
STRIPE_WEBHOOK_SECRET=whsec_...

User paid but no access¶

Check webhook called update_user_plan() in webhook handler.

Stripe guide - Troubleshooting

Analytics (Top G+)¶

Analytics returns 403 error¶

User needs appropriate plan level:

Basic Analytics: Starter+ plan
Advanced Analytics: Pro+ plan
Premium Reporting: Premium subscription
Team Analytics: Enterprise subscription

Analytics guide

Deployment¶

How do I deploy to production?¶

See platform-specific guides: - Railway (recommended) - Vercel + Railway (split services) - Digital Ocean - Docker

Deployment guide

Production environment variables¶

Required for all tiers: - secret_key (strong random string) - database_url (production database) - domain (your domain)

Top G+ also needs:

Stripe keys (live, not test)
Google OAuth credentials
Email service credentials

Configuration guide

Troubleshooting¶

Task command not found¶

Bash
# Install Taskfile
# macOS
brew install go-task/tap/go-task

# Linux
sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin

# Windows
choco install go-task

Poetry not found¶

Bash
curl -sSL https://install.python-poetry.org | python3 -

Docker not running¶

Ensure Docker Desktop is running:

Bash
docker ps  # Should show containers

Python import errors¶

Bash
# Ensure Poetry environment active
poetry install
poetry run uvicorn main:app --reload

Learning Resources¶

New to FastAPI? Learn FastAPI for free - Interactive tutorials for all skill levels.

Still Need Help?¶

Check documentation:

Tier-specific:

Hustler: Check Authentication and Articles
Top G: Check Stripe Payments and Admin Panel
AI Velocity: Check AI Development

Search: Use search bar above (works across all docs)