Firefly III ecosystem overview

A quick-and-dirty overview of the Firefly III ecosystem, roadmaps and statuses and what I'm currently working on.

For more information about "semver", visit semver.org

Firefly III

Firefly III is the main topic of this overview and the principal tool around which other stuff is built.

Last commit to develop was 23 April 2024
Last commit to main was 23 April 2024 (usually coincides with the latest release)

Next patch

Next patch version: v6.1.16

0 issues open for this version

Next patch version: v6.1.17

0 issues open for this version

Next patch version: v6.1.18

0 issues open for this version

Next minor

Next major

Firefly III - Project "Layout (v2)"

I'm building a new layout for Firefly III. It's a JS based application. Every single page needs to be rebuilt. It also requires the necessary API endpoints.

Project roadmap

To do

#6331 User and group management
15 tasks to do and 1 task done
#6323 Search
13 tasks to do
#6320 Shared v3 layout functions and code
7 tasks to do
#6319 Export data
8 tasks to do
#6318 Preferences
6 tasks to do
#6317 Data management
6 tasks to do
#6316 Profile
16 tasks to do
#6315 Administration
20 tasks to do
#6314 Currencies and exchange rates
14 tasks to do
#6313 Webhooks
10 tasks to do
#6312 Help and support
7 tasks to do
#6311 Other reports and reporting engine
8 tasks to do
#6310 Default report
20 tasks to do
#6309 Recurring transactions
8 tasks to do
#6308 Rules
15 tasks to do
#6307 Piggy banks
10 tasks to do
#6306 Subscriptions (bills)
9 tasks to do
#6305 Budgets
16 tasks to do
#6303 Liabilities and debt management
6 tasks to do
#6302 Account reconciliation
8 tasks to do and 1 task done
#6301 Account overview and options
14 tasks to do
#6299 Dashboard
20 tasks to do

In progress

#6304 Transactions
31 tasks to do

Done

Nothing yet

Firefly III - Project "API (v2)"

The next major release of Firefly III will feature the ability to manage multiple financial administrations per user. Firefly III is already multi-user but it's one administration per user now. This, in combination with the new layout, requires a major API overhaul.

Project roadmap

To do

#7441 Account management endpoints
#7315 Administration management endpoints
3 tasks to do

In progress

Nothing yet

Done

Nothing yet

Data Importer

The Firefly III Data Importer is the main tool to import external data into Firefly III.

Last commit to develop was 23 April 2024
Last commit to main was 23 April 2024 (usually coincides with the latest release)

Next patch

Next patch version: v6.1.16

0 issues open for this version

Next patch version: v6.1.17

0 issues open for this version

Next patch version: v6.1.18

0 issues open for this version

Next minor

Next major

Data Importer - Project "Multi-file and compressed files import"

A project to build multi-file import support for the Firefly III data importer. This would allow you to upload multiple files, or even a compressed file with multiple importable files.

Project roadmap

To do

#6769 Mixed files accepts zipped files
10 tasks to do
#6768 Mixed files (ie. Nordigen + CSV) where each file has each own config
10 tasks to do
#6767 Mixed files can detect the file type.
10 tasks to do
#6766 CSV files where each file has each own config
10 tasks to do
#6764 CSV files without import configurations
7 tasks to do and 3 tasks done

In progress

#6765 CSV files where all files shares the same config
10 tasks to do

Done

Nothing yet

Data Importer - Project "Multi-type import"

A project to build multi-type import support for the Firefly III data importer. This would allow the data importer to import XML's and other financial data types.

Project roadmap

To do

#5396 Data importer: SimpleFIN
#3718 OFX Support
#3667 HBCI Sandbox proposal

In progress

Nothing yet

Done

Nothing yet

Documentation

The documentation is the main source of information for Firefly III.

Firefly III documentation

The main Firefly III documentation.

Repository firefly-iii/docs has 35 stars.

Documentation

API documentation

The generated API documentation is hosted on Azure.

Repository firefly-iii/api-docs has 4 stars.

API documentation

API documentation generator

The API documentation is stitched together from a collection of YAML files. This repository contains the source YAML and the combination script.

Repository firefly-iii/api-docs-generator has 9 stars.

API documentation

Tools and utilities

Tools and utilities that are built around Firefly III.

Auto-save tool

The auto-save tool shows you what you can do with the Firefly III API.

Repository jc5/autosave has 11 stars.

Product manager

The product manager is a small tool that shows you what you can do with the Firefly III API.

Repository jc5/product-manager has 31 stars.

Data generator

A tool that generates all of the filler data used on the demo site. Also used to fill my development instance with fake data. Released on Codeberg.

Source @ Codeberg

Import test data repository

A (currently private) collection of import test files. These files to validate the data importer and do exception validation.

Development tools

A small set of little development tools, used in the development of Firefly III.

Source @ Codeberg

Libraries

All supporting libraries and code.

API support classes

A collection of support classes for the Firefly III API. Used in the data importer and some other tools.

Repository jc5/api-support-classes has 4 stars.
The last commit to branch main was made on 20 April 2024 by James Cole.

Google 2FA

A small forked library to assist in generating 2FA codes. Every now and then updates are pulled from upstream.

Repository jc5/google2fa-laravel has 0 stars.
Version 2.0.8 was released on 30 March 2022
The last commit to branch main was made on 4 September 2022 by James Cole.

Google 2FA recovery

A small forked library to assist in generating 2FA recovery codes. Every now and then updates are pulled from upstream.

Repository jc5/recovery has 0 stars.
Version 2.2.0 was released on 31 March 2022
The last commit to branch main was made on 31 March 2022 by James Cole.

Builds and releases

All useful build and release tools, scripts and repositories.

Firefly III Docker image

The Docker container for Firefly III is feature complete.

Repository firefly-iii/docker has 68 stars.
Docker image fireflyiii/core:latest was last pushed on 23 April 2024
Docker image fireflyiii/core:develop was last pushed on 22 April 2024

Repository and information

Firefly III Data Importer Docker container

The Docker container for the Firefly III Data Importer is feature complete.

Repository firefly-iii/docker has 68 stars.
Docker image fireflyiii/data-importer:latest was last pushed on 23 April 2024
Docker image fireflyiii/data-importer:develop was last pushed on 23 April 2024

Repository and information

Firefly III Base Docker container

Firefly III and the Data Importer share this base image. It is pretty much feature complete and gets built every so often to update the OS and software.

Repository firefly-iii/docker has 68 stars.
Docker image fireflyiii/base:apache-8.3 was last pushed on 23 April 2024

Repository and information

Firefly III Kubernetes

A collection of Kubernetes scripts and configurations. Use it to set up Firefly III in a Kubernetes cluster.

Version 1.8.1 (full stack) was released on 20 March 2024
Version 1.8.1 (FIDI) was released on 20 March 2024
Version 1.8.1 (Firefly III) was released on 20 March 2024

Repository and information

Firefly III ecosystem overview

Firefly III

Next patch

Next minor

Next major

Firefly III - Project "Layout (v2)"

Firefly III - Project "API (v2)"

Data Importer

Next patch

Next minor

Next major

Data Importer - Project "Multi-file and compressed files import"

Data Importer - Project "Multi-type import"

Documentation

Tools and utilities

Libraries

Builds and releases

Do you need help, or do you want to get in touch?

Support the development of Firefly III