Volt. — how to use it
Volt is SME South Africa's in-house marketing studio. Write ad copy, design graphics across 14 content families (plus a free-form canvas), build the newsletter, cut webinars into branded shorts, publish straight to social, and now connect an AI tool of your own to it. This guide walks through each, start to finish.
🚀 Getting started
There are two ways to run — they look identical and share the same engine.
Web app (easiest)
- Open tshephos-lab.vercel.app in your browser.
- Nothing to install. Sign in with your @smesouthafrica.co.za work email (sign-up is invite-only — a different address will be turned away). The first time, confirm your email from the message you are sent. Bookmark the page.
Desktop app (Windows)
- Open the app.
- Sign in with your @smesouthafrica.co.za work email.
- Click ⚙ (top-right) and paste the API keys you were given. These power the AI tools.
The tools
Every page has the same menu down the left side — click a tile to switch (hover it to see the name; the Search tile, or Ctrl K, jumps to any tool):
✨ Create ✍️ Copy ⚡ Campaign 🎨 Studio 🖌️ Freeform 📊 Stats ✉️ Email 📅 Schedule 🎬 Video 🎯 SmartClip 📝 Transcribe 📖 Guide
⚡ Campaign — one brief, everything made
Describe what you're promoting in plain words and builds the whole campaign in one go: 3 ranked ad-copy angles, 3 finished creatives (rendered by Studio's engine in your brand), a newsletter subject + brief, and a 4-post publishing plan across platforms.
Then hand each piece off
- 🎨 Studio — opens the creative in the premium editor with every field pre-filled.
- ✉️ Email — pre-fills the newsletter brief; generate and send as usual.
- 📅 Schedule — loads the posts into the composer + your caption library.
- 🎬 Video — the headlines become ready hook options for a short.
↻ Reroll any single angle or creative without redoing the campaign. 💾 Save keeps it on your account; your last campaign also restores automatically when you come back. The 🧠 panel shows what has learned from your real performance — every campaign is generated with that steering it.
✨ Create — your starting point
The home page. It greets you, offers quick starts (ad copy, a short, a clip, a graphic, a newsletter, stats), and lists your recent work so you can pick up where you left off.
- The 🧠 What has learned panel shows what is working for your brand — it fills in once posts are being tracked, so it starts out empty.
- Your work is saved to your account, so it follows you between the web app and the desktop app.
✍️ Copy Lab — ad copy that's ranked for you
Generates multiple ad-copy angles for one offer, each scored so you can pick the strongest.
- Type the offer / product you're promoting.
- Describe the audience (who it's for).
- Pick the platform and tone, and how many variations you want.
- Hit Generate.
- Read the results — each angle shows hook / clarity / urgency scores, a headline, body, CTA and hashtags. Copy the one you like.
🎨 Studio — graphics & the Brand Kit
A built-in canvas for social graphics. It also holds the Brand Kit — the single source of truth for your colours, logo and name that the Video tool now reads automatically.
Set up your brand once
- Open 🎨 Studio → find the Brand Kit.
- SME South Africa is the default (red #9c1c1f, navy #0a2c3d). To add another brand, choose ➕ New brand…, set its colours, logo, name and website, and save.
- The active brand is what other tools use.
🗂️ Studio content families — pick a type, not a blank canvas
Past the free-form 🎨 Creative canvas, Studio has 14 purpose-built content families — each with 3 (some 4) pre-designed directions that share one field shape, so switching direction never loses what you typed. Five of them can auto-fill themselves from a pasted article link, saving the retyping entirely.
The general workflow
- Open 🎨 Studio → Post type → pick a family from the grid (or Change ▾ once you already have one selected).
- If it supports auto-fill (see table below), paste the article link into the box that appears and hit ✨ Fill — it reads the page and fills every direction at once. Otherwise, fill the fields by hand under Content.
- Pick a Design direction — the visual treatment. All directions share your typed content, so trying each is free.
- Pick Dimensions: Square (1080×1080, IG grid), Portrait (1080×1350, IG feed), Landscape (1200×628, LinkedIn), Story (1080×1920, Reels/Stories).
- ⬇ Download HD PNG, or hand it straight to 📅 Schedule from the Export step.
All 14 families
| Family | What it's for | Auto-fill? |
|---|---|---|
| 💰 Funding | Funding opportunities/grants for SMEs | — |
| ◆ Solutions | Tool/software reviews and comparisons | — |
| ✉ Newsletter | "This Week Inside" style — 3 linked stories in one post | — |
| ▤ Resources | Downloadable guides, templates, checklists | — |
| 🤝 Get Providers | SME asking for service providers | — |
| 🔎 Find Providers | Marketplace listing of providers by category | — |
| 🎙️ Podcast | Episode card, guest pull-quote, "now playing" | — |
| 📰 Latest Insight | Any regular article — quote, figure, 3 takeaways | ✓ paste the link |
| 🧑💼 Founder Focus | Forbes-style founder profile/interview piece | ✓ paste the link |
| 📚 Roundup | Bundle 2–5 separate articles into one post instead of posting each on its own | ✓ paste up to 5 links |
| 🛍️ Merch | Shop/store product drops and the collection | — |
| 🏛️ SME Hub | Community membership — the free-join card, and the "members only" lock | — |
| 📖 Glossary | One term, defined — for the Glossary section of the site | ✓ paste the term link |
| 🎟️ Webinars | Upcoming/replay webinar promotion | — |
🖌️ Freeform — edit a design by hand
A blank canvas for when a Studio design is close but you want to move things around. Any finished Studio design can be sent here as editable objects (text, shapes, images) instead of a flat picture.
- Pick a size, then add, move and restyle objects; your canvas is autosaved as you go.
- Download the result as a PNG. If the canvas is too large to autosave you are told — download the PNG to keep it.
📊 Stats — read your numbers
Turn raw metrics into a decision-ready read. Two ways to use it.
Manual
- Type in your metrics for the period and the goal → get a scored analysis with benchmarks, wins, risks and actions.
Live (Postiz)
- If a Postiz key is connected, pull your channels, view 7 / 30 / 90-day stats, and open Top Posts for an AI playbook of what to repeat.
Newsletter stats + subject audit
- Real open/click numbers for recent Kit sends, plus scored advice on your subject lines — this replaced the old standalone Audit tool; there's no separate profile-audit page any more.
✉️ Email — build the newsletter
Describe the week's content, and builds a Kit-ready newsletter in the fixed SME house style. You can then edit it right in the preview and push it to Kit.
Build it
- In the big box, describe this week's content — the theme and the sections you want.
- Add the exact links may use (text + URL). It only uses these and never invents a URL.
- Fill the Email subject and Preview text (used when you send to Kit).
- Toggle any promo blocks you need — webinar banner, free resource, sponsored mention, weekly action — and fill their details.
- Hit Build email. The live preview appears on the right.
Edit it — right in the preview
- Click any body text and type to fix wording — no code, no templates. The header, footer and promo blocks stay locked.
- Use the toolbar for B bold, I italic, H2 heading, 🔗 Link, and 🖼 Image.
- Add an image: click 🖼 Image → paste a hosted image URL (or upload a file if image hosting is set up) → Insert.
- ↻ Refresh re-applies promo blocks after you change them.
Send it
🛫 Pre-flight — one click checks the email the way a deliverability pro would: broken or placeholder links, Gmail's ~102KB clipping limit, spam-trigger phrases, subject/preview length, missing image alt text, and whether your site links carry UTM tags (one click auto-tags them so Stats can attribute the send). Blockers also stop Send to Kit on the first click — fix them or click again to override.
Pre-flight also enforces editorial standards: it flags a salutation you've opened with 3+ sends in a row, warns when promotional blocks are stacked at the bottom instead of woven through the read (✦ Blend promos interleaves them for you — first one lands within two sections of the greeting), catches typos instantly, and 🔤 Deep grammar check runs a full grammar/spelling pass.
📨 Send test — before anything touches Kit, send a real copy to your own inbox. Click Send test above the preview, enter up to 3 addresses (comma-separated) and hit Send it. The subject arrives prefixed with [⚡ Volt Test] so it can never be confused with the real send. Use it to check how the design actually lands in Outlook and Gmail, fix anything, then send the finalised draft to Kit.
- ✉ Send to Kit creates a draft broadcast in Kit. It does not send — you set the audience and hit send inside Kit.
- Prefer the old way? Copy HTML or Download .html still work.
📅 Schedule — publish, direct
Compose once, then choose where it goes. Instagram, Facebook and TikTok publish directly from — no third-party scheduler in between, so if something fails you see that platform's own error, not someone else's paraphrase of it. Everything else still runs through your connected Postiz instance.
Compose a post
- Pick the post type: Feed, ✨ Story or 🎬 Reel — the composer's preview shape changes to match (a Story/Reel previews as a real vertical phone frame).
- Load an image — from a Studio export, a file, or Campaign's hand-off.
- Write the caption. A Story carries no caption on the real platform — already knows this and won't try to attach one.
- Tick which connected channels this goes to (Instagram/Facebook direct, or any Postiz channel).
- Choose ⚡ Post now, 🗓️ Schedule for later, or 📝 Save draft (Postiz channels only — Instagram/Facebook/TikTok have no drafts over their own APIs, only "now" or "later").
The calendar
One merged view, bucketed by day — pulls from three sources at once (your Postiz queue, and 's own Instagram and Facebook queues) instead of three separate lists.
Instagram, Facebook & TikTok — one-time connection
- Instagram + Facebook share one connection — connect once in Admin by pasting a Meta access token, and both light up (Facebook needs one extra permission on that token). Handles feed posts, Stories and Reels (Instagram); feed posts and real Stories (Facebook — Facebook Reels aren't supported yet, Volt will tell you plainly rather than posting the wrong thing).
- TikTok is its own sign-in (OAuth, not a pasted token) — connect in Admin. Every TikTok post is private-only until TikTok finishes reviewing the app for public posting; the composer says so up front.
🎬 Video — webinar → branded short
The deepest tool. Upload a recording, cut the moment, brand it, caption it, and export. Controls sit right under the video — no scrolling.
The full workflow
- Upload your webinar clip (step 1 on the left).
- Trim to the moment with the Start / End sliders (step 2).
- Format & framing (step 3): pick 📱 9:16, 1:1 or 16:9. Use Crop + a focus side to keep an off-centre speaker, or Blur fill to show the whole frame.
- Look (step 4): SME / Clean / Bold colour grade.
- Music (step 5, optional): add a track; the speaker's voice always stays on top.
- Branding (step 6): pick the Brand kit (pulls colours, logo & name from Studio), then toggle Intro card, Outro card, Hook overlay (first 2.5s), Progress bar and Speaker name. Upload a logo if you want to override the brand one.
- Auto-captions (step 7): click ✨ Generate captions. It plays the clip once to read the audio, then writes karaoke captions. Then style them — Highlight colour (incl. the custom picker), Position, Size, Background, ALL CAPS.
- Export (under the video): choose 🎞 MP4 (desktop) or WebM (web), then hit Export short.
More clips & transitions
Under Trim, ➕ Add clip appends more footage — b-roll, an outro shot, a second take. Each clip gets its own start/end, can be reordered (↑) or removed (✕), and they play in order after your main clip. Pick the Transition between them: Cut (instant), Fade (dip through black) or Dissolve (cross-fade). Captions and pause-tightening apply to the main clip.
Playback controls (under the video)
- ▶ Play ⏸ Pause ↻ Restart sit right below the screen with Export.
- Scrubber bar: drag it to rewind / fast-forward. Or use the keyboard: Space play/pause, ← → jump 2 seconds.
✂️ Best moments (auto-highlights)
After captions are generated, a Best moments section appears.
- Click ✨ Find highlights — the AI reads the transcript and ranks the most clip-worthy moments.
- Each result shows a score, a time range, a one-line reason and a suggested hook.
- Tap a card → trims straight to that moment and pre-fills its hook. Regenerate captions on the tight clip, then export.
📝 Post copy & hooks
- Pick a platform and hit Generate post copy — you get a caption, hashtags and 3 hook ideas written from the transcript.
- Tap a hook to drop it onto the video as the on-screen hook overlay.
- Need subtitles as a file? ⬇ .SRT downloads them.
⚡ Chop all into shorts — one click exports every highlight as its own branded, captioned short, one after the other, hands-off. Captions are carried over per clip automatically (no re-transcribing). Keep the tab focused until it finishes.
⏩ Tighten pauses — after captions are generated, one click removes long silences from the clip. Preview and export both skip the dead air, captions and .SRT stay in sync, and the same button undoes it.
🎯 SmartClip — find the moment for you
Video makes you pick the clip. SmartClip finds it. Drop in a full podcast, webinar or Q&A recording — it reads the whole thing, scores every possible cut, and returns only the moments that stand on their own.
- Upload the full recording.
- Hit ✨ Scan — this transcribes the whole recording once (a real cost/time hit on a long episode), so it's worth doing once and reusing, not re-scanning the same file.
- Review the ranked results — each shows a score, a time range and why it was picked.
- Pick the ones worth using and hit Send to editor — the clip arrives in Video with its trim, captions and auto-frame path already set. It follows the speaker automatically, so a portrait crop keeps them in shot even if they move.
🛠️ Admin — owner-only setup
One-time setup and account-wide switches, kept off the daily tab bar on purpose. Restricted to the account owner; changes apply to everyone in the org.
- Modules — hide a whole tool from the nav/rail. Anyone with it already open keeps working; it just stops being offered to others.
- Studio designs — retire an overused look from Studio's picker. Retiring never touches graphics already exported.
- Premium content types — turn a Studio family on/off org-wide.
- Instagram & Facebook / TikTok — the one-time social connections used by Schedule.
- 🔌 AI Tools (MCP) — generate the key that connects an outside AI tool to . Full walkthrough in the next section.
🔌 Connect AI Tools (MCP)
speaks MCP (Model Context Protocol) — the open standard most AI tools now support for connecting to outside apps. Once connected, Claude Desktop, Claude Code, or any other MCP-compatible tool can generate on-brand copy and read your Brand Kit without leaving that tool.
1. Generate a key
- Open Admin → 🔌 AI Tools (MCP).
- Click Generate key.
- Copy the key (
sk_volt_…) immediately — it's shown exactly once and can't be retrieved again. Losing it just means generating a new one (which retires the old one automatically).
2. Point your AI tool at it
Every MCP client asks for the same three things, just in a different-shaped form:
| What it asks for | What to enter |
|---|---|
| Server URL / endpoint | /api/mcp |
| Auth header | Authorization: Bearer sk_volt_… (your key) |
| Transport | Streamable HTTP (the standard remote-MCP transport — no local install, nothing to keep running) |
Claude Code
claude mcp add --transport http volt /api/mcp --header "Authorization: Bearer sk_volt_..."
Claude Desktop
Settings → Connectors → Add custom connector — paste the URL above, add the Authorization header with your key.
3. What it can do
- get_brand_kit — reads your saved Brand Kit(s): colours, tagline, CTA, URL and each brand's voice/tone description, plus which is active. A connected AI tool should call this first so anything it writes matches your real voice.
- generate_ad_copy — several ranked ad/post copy variations (framework, headline, body, CTA, hashtags, scores), written in your active Brand Kit's voice automatically.
- generate_email_copy — the body HTML for one newsletter section from a brief, in the newsletter's established voice — never invents facts, links or figures beyond what you give it.
Rotating or revoking
Same Admin card. Rotate key replaces the active key immediately (the old one stops working — update every connected tool). Revoke disables access entirely until you generate a new one. Only one key is active per account at a time.
⌨️ Shortcuts & export reference
Video keyboard
| Key | Does |
|---|---|
| Space | Play / pause the preview |
| ← / → | Rewind / fast-forward 2 seconds |
| Drag the bar | Scrub anywhere in the timeline |
What each tool gives you
| Tool | Output |
|---|---|
| Copy Lab | Ranked ad angles (headline, body, CTA, hashtags) |
| Campaign | Ad angles + creatives + newsletter brief + publishing plan, in one go |
| Studio | Social graphics across 14 content families (downloaded image) |
| Stats | Benchmarked read + action list, plus real Kit/Postiz numbers |
| Kit-ready HTML (copy, download, or push to Kit) | |
| Schedule | Published or queued post — direct to Instagram/Facebook/TikTok, or via Postiz |
| Video | Branded short (.mp4 desktop / .webm web) + .SRT |
| SmartClip | Ranked clip-worthy moments from a full recording, sent straight to Video |
| MCP | On-brand copy and Brand Kit data, generated from an outside AI tool |
🛟 Troubleshooting
| You see… | Do this |
|---|---|
| "… API key required" (desktop) | Click ⚙ → paste the matching key. Copy/Stats/Email need Gemini; captions need Groq. |
| Captions won't generate | The clip needs sound, and a Groq key must be connected. It plays the clip once to read audio — let it finish. |
| Can't export MP4 | MP4 is desktop only. On the web app, export is WebM. (If desktop MP4 errors, it saves WebM as a fallback.) |
| Email image missing when sent | Use a hosted image URL — uploaded files only show in preview unless image hosting is set up. |
| "Send to Kit" says not connected | A Kit API key is needed (web: in Vercel; desktop: ⚙ Settings). |
| Schedule says "⚠ CRON_SECRET not set" | Scheduling-for-later is off on the server — only Post now works until it's set. One-time fix, not something to work around. |
| TikTok posts are all private | Expected until TikTok finishes reviewing the app for public posting — not a bug, see Schedule. |
| MCP tool "Missing or invalid API key" | Generate/rotate a key in Admin → AI Tools (MCP) and make sure the connected tool has the exact sk_volt_… value in its Authorization header. |
| New change not showing (web) | Hard-refresh the page (Ctrl+F5). |