PapierTiger to Clarify

PapierTiger tames German bureaucracy with Gemini. Clarify, our future, transforms those documents into language lessons helping immigrants master German from their own paperwork and beyond.

Comment

🐯 PapierTiger to Clarify - My Hackathon Journey

Built solo in 3 weeks with Google's Antigravity AI as my coding partner

💡 The Story

How It Started

Picture this: You move to Germany. You're excited, nervous, ready for a new chapter. Then your mailbox starts filling up. Rental contracts. Tax letters. Insurance forms. Utility bills. Everything's in German. Everything's important. Everything's... terrifying.

Germans have a word for this: "Briefkastenangst" - mailbox anxiety. And trust me, it's real.

I've been there. Watching friends panic over letters they can't read, missing deadlines they didn't understand, paying penalties because they couldn't decipher the fine print. I thought: There has to be a better way.

So I built PapierTiger - a digital tiger butler who stands between you and the scary paperwork. Upload a document, and "Herr Tiger" (yes, I gave him a personality) analyzes it, translates it, tells you what matters, and even cracks a sarcastic joke to make you feel better.

The name means "paper tiger" in German - something that looks scary but isn't once you understand it. That's exactly what bureaucratic documents are.

🔄 The Plot Twist

Here's where it gets interesting. I started testing PapierTiger with a small group of immigrant friends. They loved it! Finally, they could understand their contracts. No more Google Translate copy-pasting. No more panic attacks over official-looking letters.

But then something unexpected happened.

One friend, after reading her translated rental contract, looked at me and said:

"This is amazing. But... how do I actually learn these words? Tomorrow I'll forget what 'Kündigungsfrist' means and I'll need the app again."

Another friend showed me his phone - literally hundreds of screenshots of translations. Same grocery store signs. Same restaurant menus. Week after week. Same words. Still couldn't remember them.

That's when it hit me: People don't just want to understand their documents. They want to understand the language.

And here's the beautiful irony - they were already reading the most personally relevant German text of their lives! Their own rental contracts. Their own tax letters. Words that actually matter to their day-to-day survival. But it was all passive. Read once, forget, repeat.

✨ Enter: Clarify

That feedback planted a seed. What if PapierTiger wasn't just a translation tool? What if it became a learning tool?

Imagine this: You get your phone contract translated. The app highlights "Kündigungsfrist" (cancellation period). Instead of just telling you what it means, it says:

"This word appears in Section 5. You need to cancel 3 months early or you're locked in for another year. Want to practice this word before your renewal date?"

You learn it. Not because some gamified app told you to, but because missing it costs you €500.

That's Clarify - turning your real-life German documents into your personal language curriculum. Learn "Miete" (rent) from your actual rental contract. Learn "Steuerbescheid" (tax assessment) from your actual tax letter. Learn words that matter to YOUR life, when they matter, with stakes that make them stick.

🚀 What PapierTiger Does Today

Right now, PapierTiger is a full-featured document intelligence app powered by Google's Gemini 3 Flash. Think of it as your personal assistant who reads German bureaucracy so you don't have to.

📄 The Document Detective

You snap a photo or upload a PDF. PapierTiger uses Gemini to figure out what it is - receipt, invoice, contract, official letter? It pulls out the important stuff: deadlines, amounts, who's involved, what you need to do. Then Herr Tiger gives you a witty summary and full translation. It's like having a sarcastic German friend explain your paperwork over coffee.

📋 The Contract Whisperer

Got a rental contract that looks like hieroglyphics? PapierTiger breaks it down. Who's who. What you're agreeing to. Payment terms. Cancellation rules. Red flags. And it gives you an ELI5 (explain like I'm 5) version because legal German is nobody's friend.

💰 The Money Tracker

Since the app sees all your receipts and bills, it started noticing patterns. "Hey, you spent 40% more on groceries this month." "Your insurance went up." It even gives spending forecasts and savings tips. Herr Tiger went from document reader to financial advisor.

🔒 The Infrastructure Nerd Stuff

(aka the part I'm secretly proudest of)

This thing handles large PDFs by chopping them into chunks, syncs across devices without losing data, caches intelligently to handle Gemini's API rate limits, and encrypts everything. It's production-ready and deployed on Serverpod Cloud with real users testing it right now.

⚙️ How I Built This (The Technical Adventure)

🛠️ The Stack

I went all-in on the Google ecosystem:

  • Flutter for the app
  • Gemini 3 Flash for the AI brain
  • Google Cloud Storage for files
  • Google OAuth for login
  • Serverpod backend in Dart with PostgreSQL and Redis caching

And here's the kicker - I built all of this solo in 3 weeks. How? Google's Antigravity AI became my pair programming partner. I'd describe what I needed, Antigravity would help me architect it, write it, debug it. We cranked out:

  • 26 database models
  • 13 API endpoints
  • 14 backend services

Things that would normally take a team months.

⚔️ The Technical War Stories

🔴 The Gemini Quota Crisis

Early on, I hit rate limits hard. Users uploading documents, app crashing, chaos. I built a custom rate limiter (token bucket algorithm) that queues requests and backs off exponentially. Now Gemini quotas are graceful, not catastrophic.

🔴 The 512KB File Upload Disaster

Turns out platforms have request size limits. Tried to upload a fat PDF? Boom. Dead. Solution: Chop files into 500KB chunks, upload separately, reassemble server-side. Now you can upload a 10MB contract like it's nothing.

🔴 The JSON Truncation Nightmare

Gemini sometimes returns JSON that cuts off mid-sentence. Or wraps it in markdown code blocks. I wrote a JSON repair function that balances quotes and braces, extracts from markdown, and salvages partial responses. Went from 60% success rate to 95%+.

🔴 The Translation Vagueness Problem

First prompts gave me summaries, not full translations. Users wanted EVERY word translated. So I engineered detailed prompts: "VERBATIM TRANSLATION. LINE BY LINE. DO NOT SKIP ANYTHING." Worked like magic.

🎯 What I Learned

Honestly? Building PapierTiger solo taught me more than any team project ever did.

AI-assisted development is real - Antigravity isn't just autocomplete. It understands architecture. It suggests optimizations. It debugs complex issues. I spent 40% of my time on prompt engineering for Gemini, and Antigravity accelerated debugging by 10x.

Context is everything - Users don't want generic translations. They want their specific contract explained. That personal relevance is what makes PapierTiger useful and what'll make Clarify revolutionary.

Serverpod is underrated - Type-safe client generation, built-in streaming, easy deployment. It removed so much boilerplate that I could focus on features, not infrastructure.

Gemini's multimodal capabilities are insane - Throw a PDF at it. Throw an image. It just... works. No OCR. No preprocessing. Pure magic.

🔮 Where This Goes Next (The Clarify Vision)

📊 The Market Reality Check

Right now, immigrants have options:

  • Language apps teach you "the cat drinks milk" but not "your contract renews automatically in 30 days"
  • Translator devices translate on demand but create dependency - you never actually learn
  • Document helpers organize your files but don't turn them into lessons

Nobody's connecting the dots. Your documents ARE your curriculum. The most relevant, high-stakes German text you'll ever read.

🧠 The Clarify Hypothesis

Learning sticks when:

  1. The material is personally relevant (your contract vs textbook example)
  2. There are real stakes (miss the deadline, pay €500)
  3. The context is immediately useful (you need this word tomorrow)

Example: You get a letter about "Kündigungsfrist" (cancellation period).

Traditional app: Learn it in Week 47 of a course, forget by Week 48

Translator: Look it up, forget, look it up again next month

Clarify: Learn it because it's in YOUR contract with YOUR deadline that costs YOU money if you mess up

That's learning that sticks.

🗺️ The Roadmap

Phase 1: Vocabulary Engine

  • Extract words from your documents, classify them by difficulty (A1-C2)
  • Build your personal dictionary
  • "You've learned 47 words from your documents. 12 are advanced legal terms."

Phase 2: Clarify Camera

  • Point your phone at a menu, sign, or letter
  • ML Kit OCR + Gemini extracts vocabulary instantly
  • "This menu has 8 words you don't know. Let's learn them before you order."

Phase 3: Spaced Repetition

  • Smart review scheduling tied to real deadlines
  • "Review 'Kündigungsfrist' today - your contract renews in 2 weeks"
  • Progress tracking: Survival Mode → Office Manager → Native Navigator

Phase 4: Conversational Practice

  • Gemini roleplays scenarios from YOUR documents
  • "Call your landlord about the heating"
  • Voice practice. Adaptive difficulty. Start with A1 greetings, end with C1 negotiations.

Phase 5: Audio & Speech Learning

  • Speech-to-Text Practice: Speak your vocabulary words, get instant pronunciation feedback
  • Text-to-Speech Narration: Listen to your documents read aloud in natural German voices
  • Video Understanding: Upload apartment tour videos, learn room names and real estate vocabulary from the actual footage
  • Audio Lessons: Convert your contract vocabulary into personalized podcast episodes for commute learning

Phase 6: AI-Powered Content Generation

  • Document Podcasts: Generate two-host podcast discussions about your rental contract - "Why does Section 5 matter to you?"
  • Bedtime Stories in German: Your tax letter becomes a fairy tale teaching you financial vocabulary
  • Audiobook Mode: Your insurance policy narrated as a dramatic reading with vocabulary pauses
  • Interactive Conversations: Chat with Gemini about your documents - "What happens if I move out early?"
  • Custom Learning Content: Generate stories, dialogues, and scenarios using ONLY vocabulary from YOUR documents

🌟 The Big Picture: Your AI Integration Companion

PapierTiger protects you from bureaucracy. Clarify teaches you to master it.

Imagine a typical day:

Morning Commute:

  • Listen to a 10-minute podcast Gemini generated about your upcoming contract renewal
  • Practice pronunciation with speech-to-text feedback
  • "Kündigungsfrist" scores 85% - getting better!

Lunch Break:

  • Point your phone at the cafeteria menu (video mode)
  • Gemini highlights "Spätzle" - you haven't learned this yet
  • Hear the pronunciation, see it used in a sentence, save to your vocabulary

Evening:

  • Tax letter arrived today
  • Gemini reads it aloud, pausing to explain each term
  • Generates a bedtime story: "The Brave Immigrant and the Steuerbescheid Dragon"
  • You fall asleep learning "Einkommensteuer" without even trying

Weekend:

  • Contract renewal practice session
  • Full voice conversation with Gemini playing your landlord
  • Record yourself, get feedback on grammar and confidence
  • Generate a podcast explaining your rights as a tenant

It's not just a language app. It's your AI companion for integration.

🏆 Final Thoughts

This project started as a way to help friends navigate German bureaucracy. It evolved into something bigger - a vision for how immigrants can turn their scariest documents into their best learning tools.

Every translation could be a lesson. Every contract could be a course. Every deadline could be a motivation.

"Don't just translate your life. Master it." 🐯

Built With

Share this project:

Updates