Skip to content

hashmil/ad-jargon

Repository files navigation

Ad Agency Jargon Translator

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

Ad Agency Jargon Translator Screenshot

✨ Features

  • 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

🚀 Demo

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"

🛠️ Tech Stack

  • 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

🚀 Quick Start

# 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

📝 Development Commands

  • npm run dev - Start development server with Turbopack
  • npm run build - Build production application
  • npm run start - Start production server
  • npm run lint - Run ESLint for code quality

🏗️ Architecture

Translation System

The app uses AI-powered translation for authentic results:

  1. OpenRouter API: Mistral model for creative, authentic jargon generation
  2. Retry Logic: Automatic retry mechanism (up to 2 attempts) for failed requests
  3. Server-Side Processing: API routes handle external calls to avoid CORS

Key Components

  • app/page.tsx - Main translator interface
  • app/api/translate/route.ts - Translation API endpoint
  • lib/translator.ts - Example phrases and type definitions
  • types/translator.ts - TypeScript interfaces

🌍 Deployment

🔥 Cloudflare Pages Guide (Recommended - Free tier includes 500 builds/month, unlimited bandwidth)

Alternative platforms: Vercel | Self-hosting | CI/CD Setup

🔑 Environment Variables

Variable Description Required
OPENROUTER_API_KEY Your OpenRouter API key for AI translation Yes

🎯 API Usage

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

📚 Documentation

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

📖 Contributing Guide | 🐛 Report Bug | 💡 Request Feature

⚠️ Disclaimer

This project is purely satirical and intended for entertainment. Any resemblance to actual corporate meetings is purely coincidental (and slightly concerning).

📄 License

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."

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors