Resources Build your deck
Build a deck that works well
What any HTML deck needs to look right on Pitchwrap and follow a walkthrough.
Any HTML deck works
- Hand-written, a page builder’s export, an AI tool’s output, or a built app (React, Vue, Svelte and the like). Upload the built files, often a
distorbuildfolder, not the source code. - Files from other websites (fonts, scripts and libraries from a CDN, data from an API) load as usual. A form that sends to another website holds the pitch for a quick review.
- A deck’s own full screen button fills the screen with the whole pitch, walkthrough included. CSS that only applies while it’s full screen (
:fullscreen) doesn’t.
Files and addresses
- Addresses starting with
/(like/images/logo.png) point to the top of the uploaded folder, as on a normal website. - Apps with their own page routes (client-side routing, like
/about) work, and keep working when the viewer reloads. - A folder address (like
/team/) opens that folder’sindex.html. - One top folder is removed: if everything is inside one folder, its contents become the top.
.DS_Storeand__MACOSXare left out. - Match capital letters exactly:
Photo.JPGlinked asphoto.jpgworks on a Mac but not on the web. - A folder called
__pitchwrapat the top isn’t allowed, andpitchwrap-notes.mdthere is read as speaker notes. - Anything a deck saves in the browser (local storage, its own cookies) starts fresh on each visit.
Make it work with walkthroughs
A walkthrough records where the deck is, not clicks. Pitchwrap recognizes:
- Slides: elements with the class
slide, reveal.js slides, or Swiper slides, where the one on screen has a class likeactive,is-active,currentorpresent. Changing slides with the arrow keys, or with a#in the address, helps playback land on the right one. - Scrolling pages: top-level
<section>elements. Positions are saved as a section and how far into it, so the deck lands on the same content on any screen. - Anything else: the position in the whole page, top to bottom.
Clicks inside the deck (tabs, toggles, accordions) aren’t recorded or replayed, so put what you want to show where scrolling or changing slides reaches it. Each slide’s or section’s first heading names it in your analytics and matches it to its speaker notes.
Images and video
- Images (JPG, PNG, GIF, WebP, AVIF, HEIC) are delivered through an image service, at most 2,560 pixels wide and in the best format each browser supports. HEIC becomes a format every browser shows.
- Videos (MP4, WebM, MOV, M4V) are converted to MP4 at up to 1080p, so they play everywhere.
- SVG images are served exactly as uploaded.
- Converting takes a few minutes. Until then, and for images over 10 MB or videos over 100 MB, the original file is served.
How a pitch is served
- The pitch’s link shows the deck filling the window, with a few small buttons over its corner and a slim “Shared with Pitchwrap” line under it.
- The deck itself loads from its own address on a separate domain,
pitchwrapcontent.com, walled off from the app and every other deck. - Inside it, a deck can’t open pop-up dialogs (alert, confirm, prompt), print, or use the viewer’s camera, microphone or location. Links to other sites and new-tab links open in a new tab, and download links save the file.
- A deck’s pages, styles and scripts are never cached, so a new version shows straight away.