Slide Developer

Technical expertise for building presentations with the Slide-Vibing runtime on Reveal.js.

Slide Structure

Basic Slide Template

<section class="bg-slate-50" style="min-height:100vh;">
  <div class="sv-slide-surface bg-white border border-slate-200 rounded-2xl shadow-xl p-10 max-w-[900px]"
       data-slide-id="slide-{cuid}"
       data-slide-title="Slide Title">
    <!-- Content here -->
    <div class="flex items-center justify-between">
      <h2 class="text-2xl font-bold text-slate-800">Title</h2>
      <div class="text-xs text-slate-500">
        <span data-sv-slide-index></span> / <span data-sv-slide-total></span>
      </div>
    </div>
    <p class="mt-4 text-slate-600">Content...</p>

    <!-- Navigation -->
    <div class="mt-8 flex gap-3">
      <button class="sv-btn" type="button" data-sv-nav="prev">Prev</button>
      <button class="sv-btn sv-btn-primary" type="button" data-sv-nav="next">Next</button>
    </div>
  </div>
</section>

Cover Slide (Excluded from Numbering)

<section data-slide-kind="cover" class="bg-gradient-to-br from-slate-50 via-indigo-50 to-slate-100">
  <!-- Cover content -->
</section>

Generate Slide IDs (CRITICAL)

Slide IDs MUST use the CUID format. Do NOT use descriptive IDs like slide-cover or slide-intro.

How to generate:

1. Start with slide-c
2. Append 20-25 random lowercase alphanumeric characters (a-z, 0-9)
3. Ensure each slide has a unique ID

Correct examples:

• slide-cm7x9k2p4w8n3v6j1q
• slide-cswgj3ah5zq89xsfpqgybi6ug
• slide-crfwo6uvb5uaye9jbw1hd57jc

Incorrect examples:

• slide-cover (descriptive)
• slide-intro-1 (descriptive)
• slide-three-forces (descriptive)

Alternatively, use SlideVibing.generateSlideId() in browser console

Navigation Attributes

Canvas Animations

canvas: {
  controllers: [
    {
      canvasId: 'myCanvas',
      slideId: 'slide-xxx',
      draw({ ctx, width, height, t, isPlaying }) {
        ctx.clearRect(0, 0, width, height);
        // Animation logic using t (elapsed ms)
      }
    }
  ]
}

• Click canvas to play/pause
• t resets when navigating away from slide
• isPlaying indicates current state

Comment Configuration

Local Storage (Default)

comments: {
  enabled: true,
  storage: { type: 'local' }
}

Power Automate Backend

comments: {
  enabled: true,
  storage: {
    type: 'powerAutomate',
    requireBackend: true,
    apiKey: '<X-Api-Key>',
    readUrl: '<URL>',
    writeUrl: '<URL>',
    updateUrl: '<URL>',
    deleteUrl: '<URL>'
  }
}

PDF Export

pdf: {
  buttonId: 'svDownloadPdfBtn',
  unlockKey: 'svDeckCompleted',
  unlockOnLastSlide: true
}

• Button hidden until user reaches final slide
• Uses ?print-pdf query parameter for print mode

Reactive State API

const { createSignal, createMemo, createEffect, batch } = SlideVibing.state;

const [value, setValue] = createSignal(initial);
const derived = createMemo(() => compute(value()));
createEffect(() => react(value()));
batch(() => { /* multiple updates */ });

CSS Classes

Tailwind Integration

Tailwind CSS is loaded via CDN. Use utility classes freely:

• Layout: flex, grid, items-center, justify-between
• Spacing: p-10, mt-4, gap-3
• Typography: text-2xl, font-bold, text-slate-800
• Backgrounds: bg-white, bg-gradient-to-br
• Borders: border, rounded-2xl, shadow-xl