EXAMPLES AND TUTORIALS - nself-org/cli GitHub Wiki

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

Billing & Payments

Authentication

Database Design

Real-time Features

File Storage

Deployment


πŸŽ₯ 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


Made with ❀️ by the nself community

Version: 0.9.8 | Last Updated: January 31, 2026

Start building something amazing today! πŸš€