A satirical web application that transforms normal business language into hilariously over-the-top advertising agency buzzwords. Perfect for impressing clients and confusing colleagues!
🎭 Try it live! | 📚 Documentation | 🐛 Report Issues
- AI-Powered Translation: Uses Mistral AI via OpenRouter for authentic jargon generation
- Retry Logic: Automatic retry mechanism with user feedback for failed translations
- Responsive Design: Beautiful gradient UI with smooth animations
- Example Phrases: Pre-loaded examples to get you started
- Real-time Translation: Instant buzzword transformation
Transform phrases like:
- "Let's think of some new ideas" → "Moving forward, we should leverage disruptive ideation to optimise our value proposition"
- "We need to discuss the budget" → "At the end of the day, we need to deep-dive into investment allocation for scalable growth potential"
- Framework: Next.js 15.3.4 with App Router
- Language: TypeScript with strict type checking
- Styling: TailwindCSS v4 with custom gradients
- AI Integration: OpenRouter API with Mistral Small 3.2 24B
- Icons: Lucide React
- Deployment: Optimised for Cloudflare Pages
# Get started in 30 seconds git clone https://github.com/hashmil/ad-jargon.git cd ad-jargon npm install echo "OPENROUTER_API_KEY=your_key_here" > .env.local npm run dev📖 Full Setup Guide | ⚡ 5-Minute Tutorial
npm run dev- Start development server with Turbopacknpm run build- Build production applicationnpm run start- Start production servernpm run lint- Run ESLint for code quality
The app uses AI-powered translation for authentic results:
- OpenRouter API: Mistral model for creative, authentic jargon generation
- Retry Logic: Automatic retry mechanism (up to 2 attempts) for failed requests
- Server-Side Processing: API routes handle external calls to avoid CORS
app/page.tsx- Main translator interfaceapp/api/translate/route.ts- Translation API endpointlib/translator.ts- Example phrases and type definitionstypes/translator.ts- TypeScript interfaces
🔥 Cloudflare Pages Guide (Recommended - Free tier includes 500 builds/month, unlimited bandwidth)
Alternative platforms: Vercel | Self-hosting | CI/CD Setup
| Variable | Description | Required |
|---|---|---|
OPENROUTER_API_KEY | Your OpenRouter API key for AI translation | Yes |
The translator uses OpenRouter's free tier:
- Model:
mistralai/mistral-small-3.2-24b-instruct:free - Cost: Free (rate limited)
- Reliability: Built-in retry logic for failed requests
| Guide | Description |
|---|---|
| Quick Start | Get running in 5 minutes |
| Architecture | System design and components |
| API Reference | Complete API documentation |
| Development | Coding standards and setup |
| Deployment | Production deployment guide |
| Troubleshooting | Common issues and solutions |
| FAQ | Frequently asked questions |
📖 Contributing Guide | 🐛 Report Bug | 💡 Request Feature
This project is purely satirical and intended for entertainment. Any resemblance to actual corporate meetings is purely coincidental (and slightly concerning).
This project is open source and available under the MIT License.
Warning: Prolonged exposure to agency jargon may cause involuntary eye-rolling and the urge to "circle back offline."
