Loading...
Loading...
into **one single app** that looks _highly polished, original, and impactful_.
### π₯ **Ad Copy Multiplier**
### π‘οΈ **Ad Compliance Checker**
into **one single app** that looks _highly polished, original, and impactful_.
This reads like a real startup README β perfect for judging.
---
# π **Rizz Ads β Global Ad Generation + Compliance Engine**
### Create, Localize, and Legally Validate Ads for Any Market in Minutes
**Powered by Lingo.dev + Cultural AI + Compliance Intelligence**
---
## π Overview
**Rizz Ads** is a unified AI platform that turns a single English ad into a **culturally adapted, locally compliant, platform-ready advertising bundle** for every global market.
It combines two powerful modules:
---
### π₯ **1. Ad Copy Multiplier**
Generate culturally optimized ad copies for 20+ regions using:
- Lingo.dev CLI for base translations
- Cultural Tone Engine for rewriting
- Platform Formatting Engine for:
- Google Ads
- Meta Ads
- LinkedIn
- TikTok
- Region rules: tone, emojis, CTA style, length constraints
---
### π‘οΈ **2. Ad Compliance Checker**
Automatically validate each localized ad against:
- Country-specific advertising laws
- Platform guidelines
- Industry restrictions
- Required disclaimers
- Banned claim patterns
Produces:
- β οΈ flagged issues
- Auto-fixed compliant rewrites
- A final corrected ad bundle per market
---
# π― Core Value Proposition
With **one upload**, companies get:
βοΈ Localized ad variations
βοΈ Cultural tone matching (US, Japan, LatAm, Germany, UAE, etc.)
βοΈ Platform-specific ad formats
βοΈ Legal + ethical compliance validation
βοΈ Auto-corrected ads that are ready for deployment
βοΈ A fully exportable multi-language ad package
This is a **marketing, growth, and ad-ops supertool**.
---
# π§± System Architecture
```
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β FRONTEND β
β Next.js App (Dashboard + Preview) β
β - Upload Ad Copy + Product JSON β
β - Select Countries & Platforms β
β - Display Generated Ads (Table + Editor) β
β - Compliance Report UI β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β BACKEND β
β Bun/Node Server β
β β
β 1. Lingo.dev Module β
β - Extract strings β
β - Translate to multiple languages β
β - Cache translations β
β β
β 2. Cultural Tone Engine β
β - Adjust tone per region β
β - Rewrite CTAs, emojis, length β
β - Maintain persuasion principles β
β β
β 3. Platform Formatter β
β - Google Ads (30-char, 90-char) β
β - Facebook/Instagram β
β - LinkedIn (long-form) β
β - TikTok hooks β
β β
β 4. Compliance Checker β
β - Platform rules (Google, Meta, TikTok, LinkedIn) β
β - Country rule packs β
β - Industry rule packs β
β - AI risk scoring β
β β
β 5. Auto-Fix Engine β
β - Suggest compliant alternatives β
β - Preserve tone + persuasion β
β β
β 6. Export Generator β
β - /ads/xx-YY.json β
β - /compliance/xx-YY.report.json β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
```
---
# π§© Features
---
## π₯ 1. Ad Localization Engine
### βοΈ Base Translation (Lingo.dev)
- Run `lingo extract` on input JSON
- Run `lingo translate` to produce locale bundles
- Zero duplication / incremental updates
### βοΈ Cultural Tone Transformer
Each region receives a custom transformation:
| Region | Tone Adjustments |
| ------- | ---------------------------------- |
| US | Direct, bold, urgency, CTA-forward |
| Japan | Polite, formal, honorific |
| LatAm | Emotional, emoji-heavy, energetic |
| Germany | Factual, detailed, low-emoji |
| France | Elegant, aesthetic |
| UAE/KSA | Respectful, conservative wording |
| India | Conversational + clarity |
### βοΈ Emoji Sensitivity Rules
- No emojis for Japan in professional ads
- Limited emojis for Germany
- High emoji tolerance for LatAm
- Avoid certain emojis in Middle East
### βοΈ CTA Generator
Example:
| Region | CTA |
| ------- | -------------------------- |
| US | "Get Started Today" |
| UK | "Discover More" |
| Mexico | "Β‘Empieza Ahora!" |
| Japan | "θ©³η΄°γθ¦γ" (See Details) |
| Germany | "Mehr Erfahren" |
### βοΈ Platform Format Adaptation
Each ad is generated in formats for:
- Google Ads (H1, H2, Desc)
- Facebook Ads (Primary text, caption)
- LinkedIn Ads (Professional tone)
- TikTok Ads (short hook lines)
---
## π‘οΈ 2. Ad Compliance Validation
### βοΈ Platform Rule Packs
Checks for:
- "Click here" (banned on Google)
- Excessive capitalization
- Sensational claims (Meta)
- Restricted words (LinkedIn)
### βοΈ Country Legislation Packs
Examples:
**EU (GDPR):**
- No misleading data usage claims
- βWe store your data safelyβ β flagged
**USA (FTC):**
- "Guaranteed results" β banned
- "Earn βΉ10,000 easily" β flagged
**India (ASCI):**
- No miracle diet claims
- Religious-sensitive language
**Japan Consumer Law:**
- Avoid exaggeration
- Formal tone required
### βοΈ Industry Packs
- Finance β no guaranteed returns
- Crypto β no βrisk-freeβ wording
- Health/Fitness β no unverified claims
- Kids advertising β strict wording
### βοΈ Auto-Fixer
Example:
β Original (Germany):
βLose weight fast β guaranteed results!β
β οΈ Flagged β illegal medical claim
β
Auto-fixed:
βSupports your weight management goals. Results may vary.β
---
# π¦ Output Structure
```
/output
/ads
en-US.json
es-MX.json
fr-FR.json
ar-SA.json
jp-JP.json
/compliance
en-US.report.json
es-MX.report.json
fr-FR.report.json
```
---
# π₯οΈ UI Flow (Next.js)
1. **Upload Base Ad Copy**
2. **Upload Product Details JSON**
3. **Select Countries + Platforms + Industry**
4. **Run Lingo Translation**
5. **Show Culturally Localized Ads**
6. **Run Compliance Scan**
7. **Display flags + fixes**
8. **Download Global Ad Package**
---
# π§ͺ Example Flow
User submits:
```
"Boost your productivity with our AI-powered writing assistant. Try it free today!"
```
Rizz Ads generates:
- π―π΅ JP version β formal, no emojis
- π²π½ MX version β energetic, emotional
- π©πͺ DE version β factual tone
- πΈπ¦ Arabic β culturally sensitive, formal
- πΊπΈ US β bold CTA
Then compliance flags:
- DE: βfreeβ needs disclaimer
- US: okay
- MX: uses emoji β allowed
- JP: too casual β auto-fixed
---
# π Why This Combined Project Will Win
- Extremely creative + deeply practical
- Lingo CLI is used _exactly_ as intended (translation backbone)
- Cultural engine + compliance engine show **real engineering depth**
- Visual output is impressive
- Solves a real-world problem for global companies
- Demonstrates mastery of:
- AI rewriting
- globalization
- legal rules
- product design
- technical complexity
This is **a full startup**, built in a hackathon.
Full-stack web application for the University of Guelph Rocketry Club featuring AI-powered chatbot, member management, project showcases, and sponsor integration.
Reactory Data (`reactory-data`) is the data, assets, and CDN repository for the Reactory platform. It provides baseline directory structures, fonts, themes, internationalization files, client plugin source code and runtime bundles, email templates, workflow schedules, database backups, AI learning resources, and static content.
globs: src/app/**/*.tsx src/components/**/*.tsx src/hooks/**/*.ts src/lib/**/*.ts
A TypeScript CLI application that initiates and maintains an autonomous conversation between two AI personas using Ollama. The app starts with user input and then continues the conversation automatically until stopped.