EXAMPLES AND TUTORIALS

nself Examples & Tutorials - Quick Access Guide

Version: 0.9.8 | Last Updated: January 31, 2026

Your one-stop reference for all nself learning resources, examples, and tutorials.

---

🚀 Getting Started (Choose Your Path)

I Want to... Deploy Something in 15 Minutes

→ Go to: Zero to Production Tutorial

Deploy a complete production app with SSL, monitoring, and backups in just 15 minutes.

---

I Want to... Build a Simple Blog

→ Go to: Simple Blog Example

Perfect for beginners. Learn PostgreSQL, GraphQL, and authentication.

Time: 30 minutes | Difficulty: Beginner

---

I Want to... Build a SaaS Application

→ Go to: Multi-Tenant SaaS Tutorial

Complete guide with tenant isolation, billing, and team management.

Time: 3-4 hours | Difficulty: Advanced

→ Or use: SaaS Starter Template

Production-ready SaaS template with everything configured.

---

I Want to... Quick Reference While Working

→ Go to: Quick Reference Cards

Printable cheat sheets for common commands, database operations, deployment, troubleshooting, and security.

---

📚 Complete Resource Index

Tutorials (tutorials/)

Tutorial	File	Difficulty	Time
Zero to Production	ZERO-TO-PRODUCTION-15MIN.md	Beginner	15 min
Multi-Tenant SaaS	BUILD-MULTI-TENANT-SAAS.md	Advanced	3-4 hours
SaaS Quick Start	QUICK-START-SAAS.md	Beginner	30 min
B2B Quick Start	QUICK-START-B2B.md	Intermediate	45 min
Marketplace Quick Start	QUICK-START-MARKETPLACE.md	Advanced	60 min
Agency Quick Start	QUICK-START-AGENCY.md	Intermediate	45 min
Stripe Integration	STRIPE-INTEGRATION.md	Intermediate	30 min
File Uploads	file-uploads-quickstart.md	Beginner	20 min
Custom Domains	CUSTOM-DOMAINS.md	Intermediate	30 min

---

Examples (examples/)

Example	Location	Status	Difficulty	Time
Simple Blog	01-simple-blog/	✅ Complete	Beginner	30 min
SaaS Starter	02-saas-starter/	✅ Complete	Intermediate	2-4 hours
E-commerce	03-ecommerce/	📋 Planned	Intermediate	3-5 hours
Real-time Chat	04-realtime-chat/	📋 Planned	Intermediate	2-3 hours
API Backend	05-api-backend/	📋 Planned	Advanced	3-4 hours
ML Platform	06-ml-platform/	📋 Planned	Advanced	4-6 hours

---

Quick Reference (reference/)

Reference	File	Purpose
Quick Reference Cards	QUICK-REFERENCE-CARDS.md	Printable cheat sheets
Service Scaffolding	SERVICE-SCAFFOLDING-CHEATSHEET.md	Custom services guide
Command Tree	COMMAND-TREE-V1.md	All CLI commands

---

Planning Documents

Document	File	Purpose
Examples Roadmap	EXAMPLES-ROADMAP.md	Development plan for all examples
Video Scripts	VIDEO-SCRIPTS.md	Scripts for video tutorials
Tutorials Summary	TUTORIALS-SUMMARY.md	Complete overview of all resources
Tutorial Index	INDEX.md	Organized tutorial catalog

---

🎯 Learning Paths

Path 1: Complete Beginner (2-3 hours)

Goal: Deploy your first application

1. ✅ Read: Zero to Production (15 min)
2. ✅ Follow: Simple Blog Example (30 min)
3. ✅ Try: SaaS Quick Start (30 min)
4. ✅ Reference: Quick Reference Cards (15 min)

Outcome: Working application deployed to production

---

Path 2: Building a SaaS (1-2 weeks)

Goal: Launch production SaaS

1. ✅ Study: Multi-Tenant SaaS Tutorial (4 hours)
2. ✅ Build: SaaS Starter Example (2-4 hours)
3. ✅ Add: Stripe Integration (1 hour)
4. ✅ Setup: Custom Domains (1 hour)
5. ✅ Deploy: Production deployment (2 hours)

Outcome: Production-ready multi-tenant SaaS

---

Path 3: Building an API (3-5 days)

Goal: Create production API

1. ⏳ Follow: API Backend Example (coming soon) (3-4 hours)
2. ✅ Study: Database design (1 hour)
3. ✅ Add: File Uploads (1 hour)
4. ✅ Deploy: Production setup (2 hours)

Outcome: Production-grade API service

---

Path 4: Advanced Topics (2-3 weeks)

Goal: Master nself

1. ✅ Complete: Multi-Tenant SaaS (4 hours)
2. ⏳ Build: E-commerce (coming soon) (5 hours)
3. ⏳ Try: ML Platform (coming soon) (6 hours)
4. ⏳ Implement: Real-time Chat (coming soon) (3 hours)

Outcome: Expert-level knowledge

---

📖 By Topic

Multi-Tenancy

• Multi-Tenant SaaS Tutorial - Complete guide
• SaaS Starter Example - Working template
• SaaS Quick Start - Fast introduction

Billing & Payments

• Stripe Integration Tutorial - Payment processing
• SaaS Starter Example - Subscription management
• ⏳ E-commerce Example (coming soon) - Order processing

Authentication

• Simple Blog Example - Basic auth
• Multi-Tenant SaaS Tutorial - Advanced permissions
• All examples include authentication

Database Design

• Simple Blog Example - Basic schema
• Multi-Tenant SaaS Tutorial - RLS & isolation
• Database Workflow Guide - Best practices

Real-time Features

• ⏳ Real-time Chat Example (coming soon) - WebSockets
• SaaS Starter Example - Subscriptions

File Storage

• File Uploads Tutorial - MinIO integration
• ⏳ E-commerce Example (coming soon) - Product images

Deployment

• Zero to Production - Quick deploy
• Quick Reference Cards - Deployment checklist
• All examples include deployment guides

---

🎥 Video Resources

Available Scripts (tutorials/VIDEO-SCRIPTS.md)

• Video 1: Getting Started (5 min)
• Video 2: Building Your First API (10 min)
• Video 3: Multi-Tenant Apps Made Easy (15 min)
• Video 4: Production Deployment (20 min)
• Video 5: Complete SaaS in 60 Minutes (60 min)

Note: Video recordings coming soon. Scripts available now for self-guided learning.

---

🔍 Quick Search

I Need to...

Install nself → Zero to Production - Installation

Setup a database → Simple Blog - Database Setup

Add authentication → Simple Blog - Auth Setup

Implement multi-tenancy → Multi-Tenant SaaS - Tenant Isolation

Integrate Stripe → Stripe Integration Tutorial

Deploy to production → Zero to Production - Deploy Section

Setup SSL → Zero to Production - SSL Config

Configure monitoring → Zero to Production - Monitoring

Troubleshoot issues → Quick Reference Cards - Troubleshooting

Check security → Quick Reference Cards - Security

---

📊 Resource Statistics

Current Status (v0.9.9)

• Total Tutorials: 11 (9 complete, 2 planned)
• Total Examples: 6 (2 complete, 4 planned)
• Quick References: 3 complete
• Video Scripts: 5 complete
• Total Documentation Pages: 20+

Completion Progress

Examples:     ████████░░░░░░░░░░░░ 33% (2/6 complete)
Tutorials:    ███████████████████░ 82% (9/11 complete)
References:   ████████████████████ 100% (3/3 complete)
Videos:       ████████████░░░░░░░░ 0% (scripts only)
Overall:      █████████████░░░░░░░ 58% complete

---

🤝 Contributing

We welcome contributions!

Ways to help:

• Write tutorials
• Create examples
• Improve documentation
• Report issues
• Share feedback

See CONTRIBUTING.md for details.

---

📞 Getting Help

1. Check Documentation

Most answers are in the docs. Use Ctrl+F to search.

2. Review Examples

See working code in examples/

3. Search Issues

Someone may have asked: GitHub Issues

4. Ask Community

Start discussion: GitHub Discussions

5. Report Bug

Found a bug? Report it

---

🗺️ What's Coming Next

v0.9.9 (Next Release)

• ✅ E-commerce example (complete)
• ✅ Real-time chat example (complete)
• ✅ Migration guides (Supabase, Firebase)
• ✅ More video tutorials

v0.10.0 (Future)

• ✅ API backend example
• ✅ ML platform example
• ✅ Kubernetes guide
• ✅ Advanced monitoring
• ✅ Performance optimization

---

📝 Feedback

Help us improve!

What do you think of the examples and tutorials?

• 👍 What was most helpful?
• 🤔 What's missing?
• 💡 What should we add?
• 🐛 Found an issue?

Share your feedback →

---

🔗 Important Links

• Main Documentation: GitHub Wiki
• GitHub Repository: nself-org/cli
• Issues & Bugs: GitHub Issues
• Discussions: GitHub Discussions
• Examples: examples/
• Tutorials: docs/tutorials/

---

Made with ❤️ by the nself community

Version: 0.9.8 | Last Updated: January 31, 2026

Start building something amazing today! 🚀