{"id":23500793,"url":"https://github.com/cioraneanu/firefly-pico","last_synced_at":"2025-05-13T12:51:00.011Z","repository":{"id":237996814,"uuid":"783685467","full_name":"cioraneanu/firefly-pico","owner":"cioraneanu","description":"A delightful Firefly III companion web app for effortless transaction tracking","archived":false,"fork":false,"pushed_at":"2025-05-02T20:04:33.000Z","size":4179,"stargazers_count":627,"open_issues_count":13,"forks_count":34,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-02T20:32:21.686Z","etag":null,"topics":["docker","expenses","firefly-iii","laravel","money","nuxt"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cioraneanu.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,"zenodo":null}},"created_at":"2024-04-08T11:27:58.000Z","updated_at":"2025-05-02T14:25:13.000Z","dependencies_parsed_at":"2024-05-06T11:47:32.908Z","dependency_job_id":"2051e669-17b1-49d0-be19-05541527c80c","html_url":"https://github.com/cioraneanu/firefly-pico","commit_stats":null,"previous_names":["cioraneanu/firefly-pico"],"tags_count":102,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioraneanu%2Ffirefly-pico","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioraneanu%2Ffirefly-pico/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioraneanu%2Ffirefly-pico/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioraneanu%2Ffirefly-pico/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cioraneanu","download_url":"https://codeload.github.com/cioraneanu/firefly-pico/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253947440,"owners_count":21988938,"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":["docker","expenses","firefly-iii","laravel","money","nuxt"],"created_at":"2024-12-25T07:00:49.499Z","updated_at":"2025-05-13T12:51:00.000Z","avatar_url":"https://github.com/cioraneanu.png","language":"Vue","funding_links":[],"categories":["Vue"],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n\n  \u003cimg src=\"docs/images/logo2.png\" height=\"100\"\u003e\n\u003c/div\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ci\u003eA delightful Firefly III companion web app for effortless transaction tracking\u003c/i\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"docs/installation.md\"\u003eInstallation\u003c/a\u003e\n·\n\u003ca href=\"https://github.com/cioraneanu/firefly-pico/issues\"\u003eSuggestion or bug?\u003c/a\u003e\n·\n\u003ca href=\"docs/architecture.md\"\u003eArchitecture\u003c/a\u003e\n·\n\u003ca href=\"docs/contribute.md\"\u003eContribution\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hub.docker.com/r/cioraneanu/firefly-pico/tags\"\u003e\n    \u003cimg alt=\"Docker Image Version\" src=\"https://img.shields.io/docker/v/cioraneanu/firefly-pico?sort=semver\u0026arch=amd64\u0026logo=docker\u0026logoSize=auto\" \u003e\n  \u003c/a\u003e\n  \n  \u003ca href=\"https://hub.docker.com/r/cioraneanu/firefly-pico/tags\"\u003e\n    \u003cimg alt=\"Docker Pulls\" src=\"https://img.shields.io/docker/pulls/cioraneanu/firefly-pico?logo=docker\u0026logoSize=auto\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n\u003ch1\u003e\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"docs/images/presentation.png\"\u003e\n\u003c/div\u003e\n\n\n\n\n## 💡About \nFor several years I've enjoyed tracking my expenses in proprietary mobile apps \nbut after getting into self-hosting I've wondered if there is an alternative that \ngives me the same functionality without losing control over my data.\nI've came across Firefly III and I instantly fell in love with all of its features. \nSeeing that it offers a REST API I've decided to play with it and make a web app that feels mobile native.\nI also wanted to convince my significant other to use it and so I had to go for the extremely challenging “Wife Approval Certification”.\nThat meant making the expense tracking process as short as possible all while still using tags and categories because who doesn't love some nice reports :innocent:\n\nSeveral (bad) ideas later I've come to this version. A transaction assistant :tophat:\n\n\u003cdiv\u003e\n  \u003cimg src=\"docs/images/demo.gif\" width=\"300\"\u003e\n\u003c/div\u003e\n\n| Action                                                                          | Result                                                                                                                                                                                                                                                                                                                                                                                        |\n|---------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| - Partially write the name of a \"tag\" + \"amount\".\u003cbr\u003e- Hit \"Save\". You're done!\u003cbr\u003e(Ex. \"elctr 28\") | - Source account is preselected in Settings.\u003cbr\u003e- Date is automatically set to \"now\"\u003cbr\u003e- Fuzzy search found a tag with name close to what you typed (\"electricity\"). It also selected all of its parent tags.\u003cbr\u003e- Category is selected by matching it to one of the tags above.\u003cbr\u003e- The description field is copied from the child tag. \u003cbr\u003e\u003cbr\u003e [Assistant tutorial](./docs/assistant.md) |\n\n\n\n\n## 🚀 Features\n- ✅ Beautiful clean minimalistic UI :fire: subtle animations and dark-theme support :first_quarter_moon_with_face: \n- ✅ Optimized for mobile, with PWA support for a native feel :iphone:\n- ✅ The Assistant makes recording an expense feel like magic :sparkles:\n- ✅ Expand Firefly data with icons for all resources :art:\n- ✅ Expand Firefly \"tags\" with the option of subtags for better granularity\n- ✅ Add \"templates\" to make auto-completing fields a breeze :loudspeaker:\n- ✅ Beautiful dashboard making it easy to keep an eye on everything that matters :chart_with_upwards_trend:\n- ✅ Lots of tweaks and settings :wrench:\n- ✅ Free and open-source\n\n\n## 🔧 My setup\n**Firefly** is very flexible and that can leave people unsure about how they should organise things.\nThis is by no means the only / best way to do, but it's what works for me:\n```\n- Create asset accounts for everything (ex. one for every family member, one for each savings account). It's easier to not use any revenue/expense accounts; that way they will be threated as \"cash\" and you'll have one less field to fill inside transactions\n- Create your big, general \"Categories\" (ex. Bills, Food, Fun, Transportation etc.)\n- Create your root tags with names identical to the \"Categories\" above (ex. Bills, Food, Fun, Transportation etc.) (This is useful because selecting a \"Tg\" will automatically select the \"Category\".)\n- Create your child tags for granularity (ex. Electricity, Heating, Internet with the parent tag Bills). It's a good idea to remember these names and use them with the assistant for super fast expense tracking\n- Create a tag, name it \"todo\", and set the \"Mark as to-do\" field to Yes. Add this tag to any transaction that will be edited later. Ex. You paid dinner for multiple people and some will give you the money back later. Or you buy multiple shoes and return some of them. All these transactions will show up on your dashboard.\n- Go to Settings -\u003e New transaction defaults -\u003e Set your default source account. \n  - (Optionally) If there are multiple users sharing an account you can create separate \"tags\" with their names. Then everyone can select their own for the \"Auto tags\" field.\n- Identify any transactions that you perform often but cannot be turned into \"Reapeating transactions\" because of irregularities. Create \"templates\" for them. The assistant can easily handle them as well.\n- For budgets you can setup \"Rules\" inside Firefly III. When a transaction is created, if it has a list of tags, asign it to your desiered budget. \n\n- Finally make the process of starting the app faster:\n  - [iOS] Create a home screen shortcut: open the app in Safari -\u003e Share icon -\u003e Add to Homescreen. The app will also show up in you iOS global search\n  - [iOS] [Optional] Add double tap shortcut: \n    - Open Shortcuts app -\u003e + -\u003e Add action -\u003e search for \"Open URLs\" -\u003e Enter the pico deployment URL -\u003e Tap toolbar and rename it to \"Open Pico\"\n    - Open Settings -\u003e Accesibility -\u003e Touch -\u003e Back tap -\u003e Double tap -\u003e Select the shortcut created above.\n```\n\n\n\n## 📑 Notes\n- Split transactions will show up as read-only, and you cannot create them inside **Pico**. Separate transactions make more sense to me.\n- Although I'm aiming to make **Pico** support as many functionalities as possible, some resources (like \"Rules\") will remain to be handled inside Firefly III.\n\n\n## :coffee: Support\nIf you enjoy Firefly-Pico please give this repository a star ⭐️.\n\n## :crown: Attribution\nJust like Firefly III this is licensed under the [GNU Affero General Public License v3](./LICENSE).\n\n- Developed by Mihai Cioraneanu\n- Using [Laravel](https://laravel.com/) and [Nuxt](https://nuxt.com/)\n- Consuming the [Firefly III](https://www.firefly-iii.org) REST API\n- With a custom UI theme based on [Vant](https://vant-ui.github.io)\n- Exchange rates powered by [Exchange Rate API](https://www.exchangerate-api.com)\n- IconPacks: [Tablr Icons](https://tabler.io/icons) · [Fluent UI System Icons](https://github.com/microsoft/fluentui) · [Circle Avatar Vectors by Laura Reen](https://www.svgrepo.com/author/Laura%20Reen) \n· [SVG Repo](https://www.svgrepo.com/) · [Freepik](https://www.freepik.com/)\n- Illustrations: [unDraw](https://undraw.co)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcioraneanu%2Ffirefly-pico","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcioraneanu%2Ffirefly-pico","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcioraneanu%2Ffirefly-pico/lists"}