{"id":13632783,"url":"https://github.com/ilkome/finapp","last_synced_at":"2025-04-18T05:33:19.115Z","repository":{"id":22388046,"uuid":"121473383","full_name":"ilkome/finapp","owner":"ilkome","description":"Open source personal finance application","archived":false,"fork":false,"pushed_at":"2024-10-29T09:24:14.000Z","size":13933,"stargazers_count":119,"open_issues_count":1,"forks_count":40,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-29T11:40:17.269Z","etag":null,"topics":["firebase","nuxt","stylus","tailwindcss","vuejs"],"latest_commit_sha":null,"homepage":"https://finapp.ilko.me","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ilkome.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-14T05:10:45.000Z","updated_at":"2024-10-22T19:10:15.000Z","dependencies_parsed_at":"2023-09-27T20:49:06.341Z","dependency_job_id":"f09ba59d-4ef1-4c2a-9ddf-540ea78b4dc6","html_url":"https://github.com/ilkome/finapp","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkome%2Ffinapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkome%2Ffinapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkome%2Ffinapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkome%2Ffinapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ilkome","download_url":"https://codeload.github.com/ilkome/finapp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223775249,"owners_count":17200481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["firebase","nuxt","stylus","tailwindcss","vuejs"],"created_at":"2024-08-01T22:03:15.591Z","updated_at":"2025-04-18T05:33:19.101Z","avatar_url":"https://github.com/ilkome.png","language":"Vue","funding_links":[],"categories":["Vue"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg align=\"center\" style=\"width:320px\" src=\"https://finapp.ilko.me/logo.png\"/\u003e\u003c/p\u003e\u003cbr/\u003e\n\n# Open source finance application\nFinapp helps you to control personal finances easily and efficiently.\n\n# 🕹 Demo\n[finapp.ilko.me](https://finapp.ilko.me/)\n\n# 🏞 Screenshots\n![Finapp 2.0.0](https://firebasestorage.googleapis.com/v0/b/finapp-17474.appspot.com/o/2.0.0%2Ffinapp-2.0.0-promo.png?alt=media\u0026token=bce821da-f5fa-4e8a-be7a-8fc0ebfaf260)\n\n# 🚀 Features\n- Works offline on all devices (Service Worker): you can see all your data. Create, edit and delete transactions.\n- Instant synchronization between all device (Firebase).\n- Optimized for mobile and PC.\n- Themes: dark and light.\n- Support multiple currencies with auto conversion.\n\n# 🦄 Technologies\n- Vue\n- Nuxt\n- Tailwind\n- Firebase\n- PWA\n\n# 📦 Setup\n\n### Project setup\n\n``` bash\n# clone the repo\ngit clone https://github.com/ilkome/finapp.git finapp\n\n# go into app's directory\ncd finapp\n\n# install dependencies\npnpm i\n```\n\n### Firebase setup\n\n- Create a Firebase project in the [Firebase console](https://console.firebase.google.com/)\n- Create Realtime Database\n- Open Realtime Database and go to Rules tab.\n- Change rules to:\n\n``` json\n{\n  \"rules\": {\n    \"users\": {\n      \"$uid\": {\n        \".read\": \"auth != null \u0026\u0026 auth.uid == $uid\",\n        \".write\": \"auth != null \u0026\u0026 auth.uid == $uid\"\n      }\n    },\n    \"currencies\": {\n      \".read\": \"auth != null\",\n      \".write\": \"auth != null\"\n    },\n    \"ratesUsd\": {\n      \".read\": \"auth != null\",\n      \".write\": \"auth != null\"\n    }\n  }\n}\n```\n\n- Go to the Project Overview and find `Get started by adding Firebase to your app` click to `web`.\n- Register an app and you will get your config.\n- You need to replace config in app's directory `services/firebase/config.js` with your config.\n\n``` bash\napiKey: 'YOUR_CONFIG',\nauthDomain: 'YOUR_CONFIG',\ndatabaseURL: 'YOUR_CONFIG',\nprojectId: 'YOUR_CONFIG',\nstorageBucket: 'YOUR_CONFIG',\nmessagingSenderId: 'YOUR_CONFIG'\n```\n\n### Enable Google Auth\n- Go to `Authentication` page\n- Click `Sign-in method` tab\n- Add `Add new provider` and select Google\n\n### Add your domain to Firebase Authorized domains\n- Go to `Authentication` page\n- Click `Sign-in method` tab\n- Scroll to `Authorized domains` and click `Add domain`\n- Add your domain name\n\n### Open exchange rates setup\n- Get your App ID at [openexchangerates.org](https://openexchangerates.org/signup/free)\n- Rename `.env.example` to `.env`\n- Set your App ID in `.env`\n\n``` bash\nOPEN_EXCHANGE_RATES=app_id\n```\n\nIf you use netlify or similar services you need to add OPEN_EXCHANGE_RATES env.\n\n## Development\n\n### Compiles and hot-reloads\n\n``` bash\npnpm dev\n```\n\n## Production\n\n### Generate for static server\n\n``` bash\npnpm generate\n```\n\nUpload `.output/public` folder to any shared hosting.\n\n# 🤪 Stay In Touch\n\n- [My Telegram](https://t.me/ilkome)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filkome%2Ffinapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Filkome%2Ffinapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filkome%2Ffinapp/lists"}