provisioning-outreach/presentations/pres-prvng/QUICKSTART.md

# 🚀 Quick Start - Provisioning Platform Presentation\n\nChoose your presentation and get started in 2 minutes.\n\n## Select Your Presentation\n\n### 🚀 Using Run Scripts (Recommended)\n\n**Choose based on your Nushell version:**\n\n```bash\n# For Nushell 0.107.1+ (most features)\nnu run.nu\n\n# For Nushell 0.95 - 0.107.0\nnu run-simple.nu\n\n# For Nushell 0.90+ (most compatible, if getting warnings)\nnu run-ultra-simple.nu\n```\n\n**Or specify presentation directly:**\n\n```bash\nnu run.nu pitch         # No need to type .md\nnu run.nu talk\n```\n\n**Benefits**:\n\n- Interactive menu if no argument\n- File validation\n- Auto-adds .md extension\n- Helpful information\n\n---\n\n### 👔 For Executives (5-10 minutes)\n\n```bash\n# With script\nnu run.nu pitch\n\n# Or direct npm\nnpm run dev pitch.md\n```\n\n**What**: Quick overview, business value, ROI\n**When**: C-level pitch, time-constrained meetings\n**Slides**: 12\n\n### 👨‍💻 For Developers (15 minutes)\n\n```bash\nnpm run dev demo-intro.md\n```\n\n**What**: Technical context before live demo\n**When**: Before hands-on demonstration\n**Slides**: 10\n\n### 🎯 For Technical Teams (30-45 minutes)\n\n```bash\nnpm run dev talk.md\n```\n\n**What**: Complete technical deep dive\n**When**: Technical presentations, conferences\n**Slides**: 25\n\n### 🏫 For Training (1-2 hours)\n\n```bash\nnpm run dev workshop.md\n```\n\n**What**: Comprehensive with exercises\n**When**: Team training, knowledge transfer\n**Slides**: 40+\n\n## 🎬 Live Demonstrations\n\nThree ready-to-run demos showing actual capabilities:\n\n```bash\n# Server creation with cost estimation (30 sec)\nbash demos/01-server-creation-demo.sh\n\n# Kubernetes deployment with dependency resolution (1 min)\nbash demos/02-kubernetes-deployment-demo.sh\n\n# Multi-cloud batch workflow orchestration (2 min)\nbash demos/03-batch-workflow-demo.sh\n```\n\n## ⚙️ Setup (First Time Only)\n\n```bash\ncd pres-prvng\nnpm install\nnpm run dev\n```\n\nThen open: **<http://localhost:3030>**\n\n## 📊 All Files at a Glance\n\n```plaintext\npres-prvng/\n├── pitch.md              # Executive overview (10 min)\n├── demo-intro.md         # Developer intro (15 min)\n├── talk.md               # Technical talk (30-45 min)\n├── workshop.md           # Complete workshop (1-2 hours)\n├── slides.md             # Master file (all 40 slides)\n│\n├── sections/             # Modular slide sections\n│   ├── 01-intro.md\n│   ├── 02-solution.md\n│   ├── 03-features.md\n│   ├── 04-security.md\n│   ├── 05-usecase.md\n│   ├── 06-demos.md\n│   ├── 07-conclusion.md\n│   └── 08-appendix.md\n│\n├── demos/                # Live demonstration scripts\n│   ├── 01-server-creation-demo.sh\n│   ├── 02-kubernetes-deployment-demo.sh\n│   ├── 03-batch-workflow-demo.sh\n│   └── README.md\n│\n├── public/\n│   └── images/\n│       └── provisioning-logo.svg\n│\n├── PRESENTATION_GUIDE.md # Complete guide\n├── QUICKSTART.md         # This file\n└── .project-tools/\n    └── presentation.toml # Configuration\n```\n\n## 🎮 Controls While Presenting\n\n| Key | Action |\n|-----|--------|\n| `→` or `Space` | Next slide |\n| `←` | Previous slide |\n| `F` | Fullscreen |\n| `S` | Speaker view |\n| `B` | Blank screen |\n| `ESC` | Overview |\n| `G` | Go to slide number |\n\n## 💡 Pro Tips\n\n### Show Only Certain Slides\n\n```bash\n# Edit slides.md to comment out sections you don't want\n# Or create custom version combining sections you need\n```\n\n### Export to PDF\n\n```bash\nnpm run export-pdf pitch.md\n```\n\nCreates `exports/pitch.pdf`\n\n### Full Screen Mode\n\n```bash\nnpm run dev -- --open\n# Then press F for fullscreen\n```\n\n### Record for Later\n\n```bash\n# Use OBS or terminal recording tools\n# Run presentation at http://localhost:3030\n# Share the recording\n```\n\n## 📋 Recommended Combinations\n\n### 15-Minute Tech Intro + Demo\n\n```plaintext\nShow: demo-intro.md (15 min)\nThen: bash demos/01-server-creation-demo.sh\n      bash demos/02-kubernetes-deployment-demo.sh\n      bash demos/03-batch-workflow-demo.sh\n```\n\n### 30-Minute Technical Talk\n\n```plaintext\nShow: talk.md (30 min)\nThen: Q&A (optional: run 1-2 demos if time allows)\n```\n\n### 90-Minute Workshop\n\n```plaintext\nPart 1: workshop.md sections 1-3 (30 min)\nBreak: (10 min)\nPart 2: workshop.md exercises (40 min)\nPart 3: Q&A + real-world examples (10 min)\n```\n\n## 🎯 What Each Presentation Covers\n\n| Feature | Pitch | Demo Intro | Talk | Workshop |\n|---------|-------|-----------|------|----------|\n| **Problem statement** | ✓ | ✓ | ✓ | ✓ |\n| **Solution overview** | ✓ | ✓ | ✓ | ✓ |\n| **Architecture** | - | ✓ | ✓ | ✓ |\n| **Feature deep dives** | - | - | ✓ | ✓ |\n| **Security details** | - | - | ✓ | ✓ |\n| **Use cases** | - | - | ✓ | ✓ |\n| **Demo context** | - | ✓ | - | - |\n| **Hands-on exercises** | - | - | - | ✓ |\n| **Advanced topics** | - | - | - | ✓ |\n| **Troubleshooting** | - | - | - | ✓ |\n\n## 🔧 Customization Checklist\n\n- [ ] Update `presentation.toml` with your company name\n- [ ] Test all demo scripts: `bash demos/*.sh`\n- [ ] Verify logo appears: Check `public/provisioning-logo.svg`\n- [ ] Practice transitions between slides and demos\n- [ ] Check terminal font size is readable (18pt+)\n- [ ] Have backup of presentation (USB, cloud)\n- [ ] Know your audience level\n- [ ] Plan timing: presentation + demos + Q&A\n\n## 🆘 Quick Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| Won't start | `npm install && npm run dev` |\n| Slides look wrong | Refresh browser (Cmd+R) |\n| Logo not showing | Check `public/provisioning-logo.svg` exists |\n| Demo script won't run | `chmod +x demos/*.sh` then `bash demos/01*.sh` |\n| Presentation lags | Close other browser tabs |\n\n## 📞 Need Help?\n\n- Full guide: See `PRESENTATION_GUIDE.md`\n- Demo details: See `demos/README.md`\n- Code reference: Check `CLAUDE.md`\n- Examples: See `provisioning/examples/`\n\n## 🎉 You're Ready\n\nChoose your presentation above and start with:\n\n```bash\nnpm run dev pitch.md    # or talk.md, workshop.md, etc.\n```\n\n**Break a leg! 🚀**\n\n---\n\n**Last Updated**: 2025-11-14\n**Variant Files**: 4 (pitch, demo-intro, talk, workshop)\n**Demo Scripts**: 3 (server, kubernetes, batch)\n**Total Slides**: 40+ (modular)