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

# Quick Start - Presentation Suite

## Run Your Presentations

### Option 1: Interactive Menu (Recommended)

```bash
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
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
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.