Pitchora

Turn source material into a presentation you can explain, edit and review.

Overview · Features · Screenshots · Quick start · Deploy · Status · العربية

Overview

Pitchora brings storyboarding, brand kits, bilingual slide composition and editable PowerPoint export into one workspace. It is for people preparing a board, committee or client presentation who need to inspect what supports the story, not just produce attractive slides.

Source material → Storyboard → Slides → Brand and evidence review → Editable export

The presentation application lives at /presentiq. The source also retains inherited learning routes and client packages (desktop/, mobile/, extension/). They are preserved, not reclassified as verified Pitchora features. See product boundaries.

Repository identity

This is ahmadzayan-hub/Pitchora-studio. A similarly named repository, ahmadzayan-hub/pitchorastudio, shares much of this code but has a separate history and has diverged (it lacks Source Studio and its delivery workflow). docs/SOURCE_STUDIO.md records this repository as the canonical source and notes that the existing pitchorastudio.vercel.app alias points to the sibling repository, not to this code. The repository guide asks that neither repository be merged, archived, renamed or rerouted without an explicit decision.

Key features

Your task	What the code provides	Important boundary
Author from your own sources	Source Studio at /presentiq/source-studio: import text PDF, TXT, Markdown or CSV in the browser, inspect page-linked excerpts, edit a storyboard and review each scene	Local single-user workflow. No model calls, no cloud sync
Hand off an editable deck	Editable PPTX, standalone HTML / print-to-PDF, JSON backup and a local video render package	Export is blocked until every scene is reviewed. The ZIP is not a video
Shape a presentation	Project wizard, narrative blueprint and slide editor	Generated content still needs a presenter's review
Keep a consistent identity	Brand kits, theme tokens and template tooling	Brand checks are not organizational approval
Inspect support for a claim	Evidence references, quality checks and review surfaces	A citation does not establish that a claim is true
Work in two languages	English / Arabic interface, composition and RTL handling	Review wording and exported layout in both languages
Find a project quickly	Projects page with text search, status filter and a mobile card layout	Filters run on the list already loaded in the page

Source Studio limits, licenses and acceptance evidence are documented in docs/SOURCE_STUDIO.md.

Screenshots

Captured from a local production build (npm run build && npm run start) in sample-data mode. The project and quality values shown are sample data.

Desktop (1440 x 900)	Mobile (390 x 844)

Quick start

Requires Node.js 22 (the version used by CI) and npm.

git clone https://github.com/ahmadzayan-hub/Pitchora-studio.git
cd Pitchora-studio
npm ci
cp .env.example .env.local
npm run dev

Open http://localhost:3000/presentiq. With the example file, NEXT_PUBLIC_DEMO_MODE=true, so the app serves deterministic sample data and skips Supabase, model providers and Stripe. Source Studio works without any backend.

For an authenticated installation, configure a dedicated development backend first and follow the setup and release guide:

• Set NEXT_PUBLIC_DEMO_MODE=false. Changing this flag alone does not connect a backend.
• Supply the Supabase URL and public key. Keep the service-role key on the server only.
• Verify the complete schema on an isolated database. Follow the schema coexistence review and the tenant enrollment review.
• Presentation generation defaults to free deterministic source extraction, even when a model key exists. A model provider is used only when explicitly selected by an approved caller.
• Missing payment configuration is not permission to use live payments for a smoke test.

Scripts

Command	What it does
npm run dev	Start the Next.js development server
npm run build	Production build
npm run start	Serve the production build
npm run lint	ESLint (next lint)
npm run typecheck	TypeScript check (tsc --noEmit)
npm test	Unit and integration tests (Vitest)
npm run generate:icons	Regenerate app icons

Browser tests for Source Studio live in e2e/ and run with npx playwright test against a production build. Database checks need an isolated PostgreSQL installation:

This is the beginning of the README. Read the rest at the original. Read the full README ↗