# Tutorials Index

Step-by-step tutorials for learning nself features and use cases.

## Overview

These tutorials provide hands-on, step-by-step instructions for implementing specific features and patterns with nself. Each tutorial includes complete code examples and explanations.

---

## Featured Tutorials

### Zero to Production in 15 Minutes ⚡
**[ZERO-TO-PRODUCTION-15MIN.md](ZERO-TO-PRODUCTION-15MIN.md)**

Deploy a complete production application from scratch in just 15 minutes. Includes SSL, monitoring, and automated backups.

**Time:** 15 minutes | **Difficulty:** Beginner | **Cost:** $10-30/month

---

## Complete Tutorials

### Building a Multi-Tenant SaaS
**[BUILD-MULTI-TENANT-SAAS.md](BUILD-MULTI-TENANT-SAAS.md)**

Comprehensive guide to building a production-ready SaaS application with:
- Complete tenant isolation (RLS)
- Stripe billing integration
- Team management and invitations
- Usage-based billing
- Admin dashboard
- Role-based permissions

**Time:** 3-4 hours | **Difficulty:** Intermediate to Advanced

---

## Quick Start Tutorials

### Use-Case Specific Quick Starts

- **[SaaS Quick Start](QUICK-START-SAAS.md)** - Build a SaaS application
  - Multi-tenant setup
  - Subscription billing
  - User roles and permissions
  - Custom domains

- **[B2B Quick Start](QUICK-START-B2B.md)** - Build a B2B platform
  - Organization management
  - Team collaboration
  - SSO integration
  - Enterprise features

- **[Marketplace Quick Start](QUICK-START-MARKETPLACE.md)** - Build a marketplace
  - Vendor management
  - Product listings
  - Order processing
  - Payment splitting

- **[Agency Quick Start](QUICK-START-AGENCY.md)** - Build for agencies
  - Client management
  - White-label branding
  - Multi-project support
  - Client billing

---

## Feature Tutorials

### Integration Tutorials

- **[Stripe Integration](STRIPE-INTEGRATION.md)** - Payment processing
  - Setup and configuration
  - Payment flows
  - Webhook handling
  - Subscription management

- **[File Uploads Quick Start](file-uploads-quickstart.md)** - File upload system
  - Direct uploads
  - Thumbnail generation
  - Virus scanning
  - Access control

- **[Custom Domains](CUSTOM-DOMAINS.md)** - Domain configuration
  - DNS setup
  - SSL certificates
  - Multi-domain routing
  - Tenant isolation

---

## Quick Reference

- **[Quick Reference Guide](QUICK-REFERENCE.md)** - Command cheat sheet
- **[Quick Reference Cards](../reference/QUICK-REFERENCE-CARDS.md)** - Printable cheat sheets

## Tutorial Format

Each tutorial follows this structure:

1. **Prerequisites** - What you need before starting
2. **Setup** - Initial configuration
3. **Implementation** - Step-by-step code
4. **Testing** - How to verify it works
5. **Next Steps** - What to do next

## Difficulty Levels

| Tutorial | Level | Time | Prerequisites |
|----------|-------|------|---------------|
| **Zero to Production** | Beginner | 15 min | Basic command-line |
| **Simple Blog** (Example 01) | Beginner | 30 min | Basic nself knowledge |
| **Multi-Tenant SaaS** | Intermediate | 3-4 hours | Database design, GraphQL |
| **SaaS Quick Start** | Beginner | 30 min | Basic nself knowledge |
| **B2B Quick Start** | Intermediate | 45 min | Multi-tenancy understanding |
| **Marketplace Quick Start** | Advanced | 60 min | Database design, payment flows |
| **Agency Quick Start** | Intermediate | 45 min | White-label concepts |
| **Stripe Integration** | Intermediate | 30 min | Payment processing basics |
| **File Uploads** | Beginner | 20 min | Storage understanding |
| **Custom Domains** | Intermediate | 30 min | DNS knowledge |

## Related Documentation

### Getting Started
- **[Quick Start Guide](../getting-started/Quick-Start.md)** - General quick start
- **[Installation](../getting-started/Installation.md)** - Installation guide
- **[FAQ](../getting-started/FAQ.md)** - Common questions

### Guides
- **[All Guides](../guides/README.md)** - How-to guides
- **[Database Workflow](../guides/DATABASE-WORKFLOW.md)** - Database design
- **[Multi-App Setup](../guides/MULTI_APP_SETUP.md)** - Multiple applications

### Examples
- **[Examples Index](../examples/README.md)** - Complete working examples
- **[Simple Blog](../examples/projects/01-simple-blog/README.md)** - Beginner example
- **[SaaS Starter](../examples/projects/02-saas-starter/README.md)** - Multi-tenant SaaS
- **[Real-time Chat](../examples/REALTIME-CHAT-SERVICE.md)** - WebSocket app
- **[Features Overview](../examples/FEATURES-OVERVIEW.md)** - Feature walkthrough
- **[Examples Roadmap](../examples/projects/EXAMPLES-ROADMAP.md)** - Planned examples

### Commands
- **[Command Reference](../commands/COMMANDS.md)** - All commands
- **[Tenant Commands](../commands/TENANT.md)** - Multi-tenancy
- **[Service Commands](../commands/SERVICE.md)** - Service management

## Contributing Tutorials

Have a great tutorial idea? We welcome contributions!

See **[Contributing Guide](../contributing/CONTRIBUTING.md)** for details on submitting tutorials.

## Learning Paths

### Path 1: Complete Beginner
1. **Zero to Production in 15 Minutes** - Get started fast
2. **Simple Blog Example** - Learn the basics
3. **SaaS Quick Start** - Build something real

### Path 2: Building a SaaS
1. **Multi-Tenant SaaS Tutorial** - Comprehensive guide
2. **Stripe Integration** - Add billing
3. **Custom Domains** - White-label features
4. **SaaS Starter Example** - Complete template

### Path 3: Building an API
1. **API Backend Example** - REST + GraphQL
2. **Database Workflow Guide** - Schema design
3. **File Uploads** - Storage integration
4. **Performance Optimization** - Scale your API

### Path 4: Advanced Topics
1. **Multi-Tenant SaaS** - Complex architecture
2. **E-commerce Example** - Payments and orders
3. **ML Platform Example** - Data science workflows
4. **Real-time Chat Example** - WebSocket features

---

## Video Tutorials

Coming soon! Subscribe to [YouTube](https://youtube.com/@nself) for updates.

Planned videos:
- Getting Started with nself (5 min)
- Building Your First API (10 min)
- Multi-Tenant Apps Made Easy (15 min)
- Production Deployment Walkthrough (20 min)
- Complete SaaS in 60 Minutes (60 min)

---

## Upcoming Tutorials

- Migrating from Supabase
- Migrating from Firebase
- Advanced Monitoring Setup
- Production Deployment Best Practices
- Custom Service Development
- OAuth Authentication Deep Dive
- Multi-Language Support
- Advanced Database Patterns
- Performance Optimization
- Security Best Practices
- Kubernetes Deployment
- CI/CD with GitHub Actions

---

**Last Updated**: January 31, 2026
**Version**: v0.9.8