Skip to content
forked from ilkome/finapp

Open source personal finance application

License

Notifications You must be signed in to change notification settings

LeanWalk/finapp

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Open source finance application

Finapp helps you to control personal finances easily and efficiently.

This is Finapp 3. For the 2.x see the 2 branch.

🕹 Demo

finapp.ilko.me

🏞 Screenshots

Finapp 2.0.0

🚀 Features

  • Works offline on all devices (Service Worker): you can see all your data. Create, edit and delete transactions.
  • Instant synchronisation between all device (Firebase).
  • Optimised 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

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

Compiles and minifies for production

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

yarn build

Upload static files to server

You can add your FTP config in app's directory ftp.config.js

# upload all files from dist folder
yarn upload

# upload only css, js, html files from dist folder
yarn upload-min

🤪 Stay In Touch

I would like to speak with you about Finapp. I'm looking for awesome projects.

📄 License

MIT License

About

Open source personal finance application

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vue 61.2%
  • JavaScript 18.2%
  • TypeScript 17.9%
  • Stylus 2.6%
  • Other 0.1%