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

Quick Start - Presentation Suite

Run Your Presentations

Option 1: Interactive Menu (Recommended)

bash
cd /Users/Akasha/project-provisioning/pres-prvng
nu run-ultra-simple.nu

Then select from the menu:

• [1] pitch.md - 10-minute executive pitch
• [2] demo-intro.md - 15-minute developer introduction
• [3] talk.md - 30-45 minute technical talk
• [4] workshop.md - 1-2 hour comprehensive workshop
• [5] full.md - Complete presentation

Option 2: Direct Launch

bash
# Launch specific presentation
nu run-ultra-simple.nu pitch       # Executive pitch
nu run-ultra-simple.nu talk        # Technical talk
nu run-ultra-simple.nu workshop    # Workshop
# ... or any other variant

What to Expect

✅ Slidev dev server starts at http://localhost:3030 ✅ Browser automatically opens with presentation ✅ Press 'S' for speaker notes ✅ Press 'F' for fullscreen ✅ Use arrow keys to navigate slides

If You See Build Errors

The presentation suite is configured to handle all common Slidev/Vite issues:

• ✅ No "Language kcl not found" errors (converted to YAML)
• ✅ No "Failed to resolve import" errors (SVG paths have ?url)
• ✅ No missing section errors (src: imports are correct)
• ✅ All logo images display correctly

If any errors occur, check:

1. Node.js and pnpm are installed
2. Dependencies are installed: pnpm install
3. Public folder exists: ls public/provisioning-logo.svg

Presentation Structure

5 Presentation Variants Available

1. pitch.md (Executive Pitch)

• Duration: 10 minutes
• Audience: C-level executives, stakeholders
• Focus: Business value, ROI, why Provisioning matters
• Sections: Problem, Solution, Quick Demo, Call to Action

2. demo-intro.md (Developer Introduction)

• Duration: 15 minutes
• Audience: Developers
• Focus: Architecture, features, getting started
• Ideal: As intro before live technical demo
• Sections: Problem, Solution, Key Features, Demo Intro, Resources

3. talk.md (Technical Deep Dive)

• Duration: 30-45 minutes
• Audience: Technical teams, architects
• Focus: Architecture, security, advanced features
• Complete reference with all components
• Sections: All (1-8) with full details

4. workshop.md (Comprehensive Workshop)

• Duration: 1-2 hours
• Audience: Teams learning the platform
• Focus: Hands-on learning with exercises
• Includes: 4 practical exercises, advanced topics, best practices
• Sections: All (1-8) + 4 exercises + advanced topics

5. full.md (Complete Reference)

• Duration: Custom (all content)
• Audience: Reference material
• Focus: Complete technical documentation
• Includes: All sections, complete appendix
• Sections: All (1-8) + technical appendices

Customization

Edit Presentation Content

Edit presentation files in versions/:

bash
nano versions/pitch.md      # Edit pitch presentation
nano versions/sections/01-intro.md  # Edit intro section

Changes are reflected immediately on save (with Slidev dev server running).

Add New Presentation Variant

1. Copy an existing presentation as template
2. Keep only the src: imports you need
3. Update run-ultra-simple.nu to include new variant
4. Run presentations to test

Modify Section Content

Sections in versions/sections/ are reused across presentations:

• 01-intro.md - Problem identification
• 02-solution.md - Architecture overview
• 03-features.md - Feature descriptions
• 04-security.md - Security details
• 05-usecase.md - Real-world examples
• 06-demos.md - Demo descriptions
• 07-conclusion.md - Getting started
• 08-appendix.md - Technical deep dives

Documentation Files

• SESSION_COMPLETION_SUMMARY.md - Complete overview of fixes and improvements
• ORGANIZATION_SUMMARY.md - Directory structure and variant descriptions
• CODE_BLOCK_FIXES.md - KCL to YAML conversion details
• SVG_IMPORT_FIX.md - Asset import resolution details

---

Ready to Present! 🎉

Simply run nu run-ultra-simple.nu and start presenting.