CarouselGen is a Next.js app for creating social media carousels from free text or structured JSON.
It supports:
- Instagram, TikTok/Reels, and LinkedIn formats
- visual slide editing
- template system (including image-aware templates)
- API parsing (
/api/parse) + generation (/api/generate) - export-ready slide output
| Area | Status |
|---|---|
| Build | Passing |
| Typecheck | Passing |
| Template render tests | Passing |
| API smoke test | Passing |
| Public demo URL | Not deployed yet |
npm ci
npm run typecheck
npm run test:templates
npm run buildAPI checks run locally:
POST /api/parsewith free text inputPOST /api/generatewith structured configGET /api/generateschema endpoint
- Next.js 16
- React 19
- TypeScript
- Tailwind CSS
- optional Anthropic API for smart parsing
- optional Unsplash API for image lookup
npm install
npm run devOpen http://localhost:3000.
| Variable | Purpose |
|---|---|
ANTHROPIC_API_KEY |
AI parsing in /api/parse |
ANTHROPIC_MODEL |
Model override |
UNSPLASH_ACCESS_KEY |
Live Unsplash image search |
Without API keys, the app still works via deterministic local fallback behavior.