Directory Structure
Pitch Smith stores all project files inside a .slide-builder/ directory at the root of your workspace. This directory is created automatically when you first run a Pitch Smith command.
This reference documents the complete directory layout and explains the purpose of each file and folder.
Default Structure
After initial scaffolding (before brand setup), the directory has this structure:
.slide-builder/
├── config/
│ ├── theme.json # Brand theme (default provided)
│ ├── design-standards.md # Professional design guidelines
│ ├── theme-history/ # Theme version snapshots
│ └── catalog/
│ ├── slide-templates.json # Slide template manifest
│ ├── deck-templates.json # Deck template manifest
│ ├── slide-templates/ # Individual slide template HTML files
│ │ ├── title.html
│ │ ├── agenda.html
│ │ └── ...
│ ├── deck-templates/ # Multi-slide deck templates
│ └── brand-assets/ # Brand visual assets
│ ├── icons/
│ ├── images/
│ └── logos/
├── templates/ # Framework templates (internal)
├── workflows/ # Workflow definitions
│ ├── setup/
│ │ ├── workflow.yaml
│ │ └── instructions.md
│ ├── plan/
│ ├── plan-one/
│ ├── plan-deck/
│ ├── build-one/
│ ├── build-all/
│ ├── edit/
│ ├── animate/
│ ├── add-slide/
│ ├── use-template-deck/
│ ├── refresh/
│ ├── theme/
│ ├── theme-edit/
│ ├── add-slide-template/
│ ├── add-deck-template/
│ ├── edit-deck-template/
│ ├── delete-deck/
│ ├── optimize-instructions/
│ └── update-brand-assets/
├── reference/
│ ├── conventions.md # Conventions and patterns reference
│ ├── theme-schema.md # Theme JSON schema reference
│ └── plan-schema.md # Plan YAML schema reference
├── status.yaml # Runtime session state
├── single/ # Single slide mode workspace
├── deck/ # Deck mode workspace
└── credentials/ # OAuth tokens (gitignored)
Post-Brand-Setup Structure
After running /pitchsmith:setup and creating a deck, the directory includes generated content:
.slide-builder/
├── config/
│ ├── theme.json # Your custom brand theme
│ ├── design-standards.md
│ ├── theme-history/
│ │ ├── theme-v1.json # Previous theme versions
│ │ └── theme-v2.json
│ └── catalog/
│ ├── slide-templates.json
│ ├── deck-templates.json
│ ├── slide-templates/
│ │ ├── title.html
│ │ ├── agenda.html
│ │ ├── content.html
│ │ ├── split.html
│ │ ├── data.html
│ │ └── ...
│ ├── deck-templates/
│ │ └── sales-pitch/
│ │ ├── template-config.yaml
│ │ └── slides/
│ │ ├── slide-1.html
│ │ └── ...
│ └── brand-assets/
│ ├── icons/
│ │ ├── icon-catalog.json
│ │ ├── dark/
│ │ └── white/
│ ├── images/
│ └── logos/
├── templates/
├── workflows/
│ └── ...
├── reference/
│ └── ...
├── status.yaml
├── single/
│ ├── plan.yaml # Single slide plan
│ └── slide.html # Built single slide
├── deck/
│ └── product-launch/
│ ├── plan.yaml # Deck plan
│ ├── slides/
│ │ ├── slide-1.html
│ │ ├── slide-2.html
│ │ └── ...
│ └── output/
│ └── product-launch/
│ ├── manifest.json # Deck manifest
│ ├── viewer.html # Standalone viewer
│ ├── slide-1.html # Output slides
│ └── ...
└── credentials/
Directory Reference
config/
Shareable brand configuration. This folder contains everything needed to reproduce your brand's visual identity — you can zip it and share it across projects.
| Path | Description |
|---|---|
config/theme.json | The brand theme file defining colors, typography, shapes, and more. See Theme Schema. |
config/design-standards.md | Professional design guidelines covering typography, spacing, density, and layout rules used during slide generation. |
config/theme-history/ | Version snapshots of the theme. Each time the theme is modified via /pitchsmith:theme-edit, the previous version is saved here. |
config/catalog/ | Template catalog containing all slide and deck templates. |
config/catalog/slide-templates.json | Manifest file listing all available slide templates with metadata (name, description, category). |
config/catalog/deck-templates.json | Manifest file listing all available deck templates. |
config/catalog/slide-templates/ | Individual slide template HTML files. Each template defines a reusable slide layout. |
config/catalog/deck-templates/ | Multi-slide deck templates. Each template is a directory containing a template-config.yaml and a slides/ folder with template HTML files. |
config/catalog/brand-assets/ | Brand visual assets organized by type. |
config/catalog/brand-assets/icons/ | Icon catalog with icon-catalog.json index, dark/ icons for light backgrounds, and white/ icons for dark backgrounds. |
config/catalog/brand-assets/images/ | Brand images used in slide generation. |
config/catalog/brand-assets/logos/ | Brand logos in various formats. |
templates/
Internal framework templates used by the slide generation system. These are not part of the shareable config and should not be edited directly.
workflows/
Workflow definitions for all Pitch Smith commands. Each workflow is a directory containing a workflow.yaml configuration file and an instructions.md file with the workflow steps.
By default, workflows run from the plugin installation. When you eject a workflow using /pitchsmith:eject-workflow, it is copied here and the local version takes priority.
| Workflow Directory | Related Command |
|---|---|
setup/ | /pitchsmith:setup |
theme/ | /pitchsmith:theme |
theme-edit/ | /pitchsmith:theme-edit |
plan/ | /pitchsmith:plan |
plan-one/ | /pitchsmith:plan-one |
plan-deck/ | /pitchsmith:plan-deck |
build-one/ | /pitchsmith:build-one |
build-all/ | /pitchsmith:build-all |
edit/ | /pitchsmith:edit |
edit-plan/ | /pitchsmith:edit-plan |
add-slide/ | /pitchsmith:add-slide |
animate/ | /pitchsmith:animate |
use-template-deck/ | /pitchsmith:use-template |
refresh/ | /pitchsmith:refresh |
add-slide-template/ | /pitchsmith:add-slide-template |
add-deck-template/ | /pitchsmith:add-deck-template |
edit-deck-template/ | /pitchsmith:edit-deck-template |
delete-deck/ | /pitchsmith:delete-deck |
optimize-instructions/ | /pitchsmith:optimize-instructions |
update-brand-assets/ | /pitchsmith:update-brand-assets |
reference/
Internal reference documentation used by workflows during slide generation. Contains the conventions guide, theme schema, and plan schema specifications.
status.yaml
Runtime session state tracking the current mode (single or deck), active deck, and workflow progress. Updated automatically by commands.
single/
Workspace for single slide mode. Contains a plan.yaml (slide plan) and slide.html (built slide output) when a single slide is planned and built.
deck/
Workspace for deck mode. Each deck is a subdirectory named after the deck (kebab-case). Inside each deck directory:
| Path | Description |
|---|---|
plan.yaml | The deck plan defining all slides. See Plan Schema. |
slides/ | Built slide HTML files (slide-1.html, slide-2.html, etc.). |
output/{deck-id}/ | Generated output directory containing the viewer and manifest. |
output/{deck-id}/manifest.json | Deck manifest indexing all built slides. See Manifest Schema. |
output/{deck-id}/viewer.html | Standalone HTML viewer for the deck. |
credentials/
OAuth tokens and authentication credentials. This directory is gitignored and should never be committed to version control.