Skip to main content

Welcome to OneLibro

OneLibro is a modern personal finance tracker built with Next.js 15, Supabase, and Plaid integration.

🚀 Quick Start​

Get started with OneLibro in less than 5 minutes:

  1. Installation Guide - Set up your local environment
  2. Architecture Overview - Understand the system design
  3. API Reference - Explore the API endpoints

✨ Key Features​

  • 🏦 Bank Integration - Connect accounts via Plaid
  • 💰 Transaction Tracking - Automatic sync from banks
  • 📊 Budget Management - Set and track spending budgets
  • 🔐 Invite-Only System - Secure user onboarding
  • 👨‍💼 Admin Dashboard - User management with 2FA
  • 📱 Mobile Responsive - Works on all devices

🏗️ Tech Stack​

  • Frontend: React 19, Next.js 15, Tailwind CSS v4
  • Backend: Next.js API Routes, Supabase
  • Database: PostgreSQL (via Supabase)
  • Banking: Plaid API
  • Authentication: Supabase Auth + Custom Admin Auth with TOTP 2FA

📚 Documentation Structure​

This documentation is organized into the following sections:

🎯 Getting Started​

  • Installation and setup
  • Environment configuration
  • First-time tasks

🏛️ Architecture​

  • System overview
  • Database schema
  • Authentication flows

📡 API Reference​

  • All API endpoints
  • Request/response formats
  • Code examples

📖 Guides​

  • Security best practices
  • Development workflow
  • Troubleshooting

📋 Reference​

  • Helper libraries
  • Utility functions
  • Type definitions

🤝 Contributing​

Contributions are welcome! Please read our development guide before submitting pull requests.

📄 License​

This project is licensed under the MIT License. See the LICENSE file for details.

🔗 Links​

Ready to get started? Head over to the Installation Guide →