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

GitHub Repo stars GitHub release (latest by date)
Firefly III is the main topic of this overview and the principal tool around which other stuff is built.

  • Last commit to develop was 30 September 2024
  • Last commit to main was 29 September 2024 (usually coincides with the latest release)

Next patch

 

Next patch version: v6.1.22
Next patch version: v6.1.23
Next patch version: v6.1.24

Next minor

See also the next minor release roadmap

Next minor version: v6.2.0
Next minor version: v6.3.0
Next minor version: v6.4.0

Next major

See also the next major release roadmap

Next major version: v7.0.0
Next major version: v8.0.0
Next major version: v9.0.0

Data Importer

GitHub Repo stars GitHub release (latest by date)
The Firefly III Data Importer is the main tool to import external data into Firefly III.

  • Last commit to develop was 1 October 2024
  • Last commit to main was 17 September 2024 (usually coincides with the latest release)

Next patch

 

Next patch version: v1.5.7
Next patch version: v1.5.8
Next patch version: v1.5.9

Next minor

See also the next minor release roadmap

Next minor version: v1.6.0
Next minor version: v1.7.0
Next minor version: v1.8.0

Next major

See also the next major release roadmap

Next major version: v2.0.0
Next major version: v3.0.0
Next major version: v4.0.0

Documentation

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

Firefly III documentation

The main Firefly III documentation.

Kept up-to-date
API documentation

The generated API documentation is hosted on Azure.

Kept up-to-date
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.

Kept up-to-date

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.

Bugfixes only
Product manager

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

Bugfixes only
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.

Bugfixes only
Import test data repository

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

Bugfixes only
Development tools

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

Bugfixes only

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.

Kept up-to-date
Google 2FA

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

Kept up-to-date
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.
Kept up-to-date

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.

Kept up-to-date
Firefly III Data Importer Docker container

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

Kept up-to-date
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.

Kept up-to-date
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
Active development

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

Do you want to contact me? You can email me at james@firefly-iii.org or get in touch through one of the following support channels:

Support the development of Firefly III

If you like Firefly III and if it helps you save lots of money, why not send me a dime for every dollar saved! 🥳

OK that was a joke. If you feel Firefly III made your life better, please consider contributing as a sponsor. Please check out my Patreon and GitHub Sponsors page for more information. You can also buy me a ☕️ coffee at ko-fi.com. Thank you for your consideration.