8000 GitHub - ilkome/finapp: Open source personal finance application
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

ilkome/finapp

Repository files navigation

Finapp Logo

Finapp — Open Source Finance App

Your money, your control — anywhere, anytime.

Finapp helps you easily track and manage personal finances.


✨ Why Finapp?

  • Simple: No clutter, no distractions — just your transactions and balances.
  • Fast: Works offline and syncs instantly across devices.
  • Private: You own your data — securely stored via Firebase.
  • Flexible: Supports multiple currencies with automatic exchange rates.
  • Portable: Optimized for mobile and desktop, installable as a PWA.

🕹 Live Demo

➡️ finapp.ilko.me


🏞 Screenshots

Finapp 2.0.0


🚀 Features

  • Offline-first (PWA) with full CRUD support.
  • Instant real-time sync across devices (Firebase).
  • Mobile-first, but optimized for desktop.
  • Dark and Light theme support.
  • Multi-currency with automatic exchange rates.

🦄 Tech Stack

  • Vue 3
  • Nuxt 3
  • TailwindCSS 4
  • Firebase
  • Progressive Web App

📦 Getting Started

1. Clone and Install

git clone https://github.com/ilkome/finapp.git finapp
cd finapp
pnpm install

2. Setup Firebase

  • Create a project in Firebase Console.
  • Enable Realtime Database.
  • Set Database Rules:
{
  "rules": {
    "users": {
      "$uid": {
        ".read": "auth != null && auth.uid == $uid",
        ".write": "auth != null && auth.uid == $uid"
      }
    },
    "currencies": {
      ".read": "auth != null",
      ".write": "auth != null"
    },
    "ratesUsd": {
      ".read": "auth != null",
      ".write": "auth != null"
    }
  }
}
  • Register a Web App in Firebase and copy the config.
  • Replace the contents of services/firebase/config.js with your config:
export const firebaseConfig = {
  apiKey: 'YOUR_API_KEY',
  a
8000
uthDomain: 'YOUR_AUTH_DOMAIN',
  databaseURL: 'YOUR_DATABASE_URL',
  messagingSenderId: 'YOUR_MESSAGING_SENDER_ID',
  projectId: 'YOUR_PROJECT_ID',
  storageBucket: 'YOUR_STORAGE_BUCKET'
}

3. Enable Google Authentication

  • In Firebase Console → Authentication → Sign-in method → Enable Google provider.

4. Authorize Your Domain (optional)

  • Add your domain under Authentication → Sign-in method → Authorized domains.

5. Setup Open Exchange Rates

OPEN_EXCHANGE_RATES=your_app_id

🛠 Development

Run local server with hot reload:

pnpm dev

🚀 Production

Generate static files for deployment:

pnpm generate

Then upload everything in .output/public to any static hosting.


Tip: Use services like Vercel or Netlify for automatic deployments.

🤝 Stay Connected

About

Open source personal finance application

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  
0