Open source finance application

Finapp helps you to control personal finances easily and efficiently.

🕹 Demo

finapp.ilko.me

🏞 Screenshots

🚀 Features

• Works offline on all devices (Service Worker): you can see all your data. Create, edit and delete transactions.
• Instant synchronization between all device (Firebase).
• Optimized for mobile and PC.
• Themes: dark and white.
• Support multiple currencies with auto conversion.

🦄 Technologies

• Vue
• Nuxt
• Stylus
• Tailwind
• Pug
• Firebase

📦 Setup

Project setup

# clone the repo
git clone https://github.com/ilkome/finapp.git finapp

# go into app's directory
cd finapp

# install dependencies
yarn

Firebase setup

• Create a Firebase project in the Firebase console
• Create Realtime Database
• Open Realtime Database and go to Rules tab.
• Change rules to:

{
  "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"
    }
  }
}

• Go to the Project Overview and find Get started by adding Firebase to your app click to web.
• Register an app and you will get your config.
• You need to replace config in app's directory services/firebase/config.js with your config.

apiKey: 'YOUR_CONFIG',
authDomain: 'YOUR_CONFIG',
databaseURL: 'YOUR_CONFIG',
projectId: 'YOUR_CONFIG',
storageBucket: 'YOUR_CONFIG',
messagingSenderId: 'YOUR_CONFIG'

Enable Google Auth

• Go to Authentication page
• Click Sign-in method tab
• Add Add new provider and select Google

Add your domain to Firebase Authorized domains

• Go to Authentication page
• Click Sign-in method tab
• Scroll to Authorized domains and click Add domain
• Add your domain name

Open exchange rates setup

• Get your App ID at openexchangerates.org
• Rename .env.example to .env
• Set your App ID in .env

OPEN_EXCHANGE_RATES=app_id

If you use netlify or similar services you need add OPEN_EXCHANGE_RATES to env variables.

Development

Compiles and hot-reloads

yarn dev

Production

Generate static files

This will give you build folder. You can upload files from this folder to any shared hosting.

yarn build

🤪 Stay In Touch

• My Telegram