Skip to content

shishiv/gastei

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Gastei Gastei

Smart expense tracking for couples. Know where your money goes β€” together.

Gastei helps couples manage shared finances with real-time tracking, smart categorization, and AI-powered insights. No more spreadsheets, no more arguments about money.

We have a functional MVP running on n8n + PostgreSQL (self-hosted schema). The focus is sharp: couples finance, with a clear differentiator β€” multi-input logging. Say "gastei 50 no mercado" in a WhatsApp voice message, and Whisper transcribes it into a categorized expense. Snap a photo of a receipt, and OCR pulls out the items, total, and category. Text, voice, or image β€” everything becomes a tracked expense.

Why Gastei Why Gastei?

Couples argue about money. Gastei removes the friction.

No spreadsheets. No manual logging. Just talk, snap, or type. Three input modes that actually work:

  • Text: "gastei 50 mercado"
  • Voice: Send an audio message
  • Photo: Snap the receipt

Done.

Features Features

  • πŸ“Š Dashboard β€” Real-time overview of expenses, income, and balances
  • πŸ‘« Couples Mode β€” Shared wallets with individual + joint spending views
  • 🏷️ Smart Categories β€” Auto-categorization powered by AI
  • πŸŽ™οΈ Voice Input β€” Send an audio saying "gastei 50 no mercado" and Whisper transcribes + logs it
  • πŸ“Έ Receipt OCR β€” Snap a photo of any receipt β€” OCR extracts items, totals, and categories automatically
  • πŸ“± Mobile-first β€” PWA optimized for quick expense logging
  • πŸ“ˆ Insights β€” Monthly trends, spending patterns, savings goals
  • πŸ”” Alerts β€” Budget limits, unusual spending, bill reminders

Tech Stack Tech Stack

Layer Technology
Frontend Next.js 15, React 19, TypeScript
Styling Tailwind CSS, Shadcn UI
Backend Next.js API Routes, Prisma ORM
Database PostgreSQL
Auth NextAuth.js
Voice OpenAI Whisper (transcription)
OCR Tesseract / Google Vision (receipt parsing)
WhatsApp WhatsApp Business API (voice + image input)
AI OpenAI GPT (categorization + insights)
Deploy Vercel + Easypanel (self-hosted DB)

How It Works How It Works

πŸ“± You                          πŸ’Έ Gastei
"gastei 50 no mercado"    β†’    πŸ’¬ Text parsed β†’ R$50 Groceries
πŸŽ™οΈ "trinta reais uber"    β†’    πŸŽ™οΈ Whisper β†’ R$30 Transport  
πŸ“Έ [receipt photo]          β†’    πŸ“Έ OCR β†’ R$127.50 (3 items)

Roadmap Roadmap

Phase 1 β€” Foundation βœ…

  • Project setup (Next.js + TypeScript + Tailwind)
  • UI component library (Shadcn)
  • Product analysis & UX research

Phase 2 β€” Core MVP 🚧

  • Auth flow (email + social login)
  • Expense CRUD (add, edit, delete, list)
  • Categories management
  • Dashboard with monthly summary
  • Couples invite & shared wallet
  • WhatsApp integration (text + voice + image input)
  • Voice-to-expense: audio β†’ Whisper β†’ parsed expense
  • Photo-to-expense: receipt β†’ OCR β†’ items + total

Phase 3 β€” Intelligence

  • AI auto-categorization from text, voice, and image inputs
  • Monthly spending insights
  • Budget alerts & notifications
  • Recurring expenses detection

Phase 4 β€” Open Finance

  • Bank account integration (Open Finance Brasil APIs)
  • Automatic transaction import
  • Credit card statement parsing
  • Multi-bank consolidated view

Phase 5 β€” Growth

  • WhatsApp bot ("gastei 50 mercado")
  • Savings goals & challenges
  • Export reports (PDF/CSV)
  • Family mode (beyond couples)

Getting Started Getting Started

# Clone
git clone https://github.com/shishiv/gastei.git
cd gastei/app

# Install
pnpm install

# Setup env
cp .env.example .env.local

# Run
pnpm dev

πŸ“„ License

MIT


Built by Myke Matos β€” TriΓ’nguloTEC

About

πŸ’Έ Gastei - Smart expense tracking for couples. Built with Next.js, TypeScript & AI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors