FlatTrack

Collaborate with your flatmates

Update for late August 2024

By Caleb Woodbine

2024-08-27

5 min read

Hi there! 👋

Thank you for checking in. It certainly has been a while since the last update post here and a lot has changed.

FlatTrack is a web service focused on helping with common needs in living situations, especially flatting.

It aims to provide useful features for several aspects of living where it makes sense for technology to assist.

It is a Free and Open Source (AGPL-3.0) project that opens the potential for anyone to build functionality that supports all in their living situations.

Since then, there have been over 12 releases since 0.0.1-alpha11-1 with many many changes up to version 0.18.4!

Here's a tour of several of those new changes.

👓 General usage

On the home page, an admin can set notes for all users to see.

To reduce the amount of taps to find the recent content, a recent section has been added to show the latest five lists.

Each page with a navigation now also has a page link copy button.

Messages can be set by administrators for setup and login.

🛍️ Shopping List

To avoid the frustration around the page scrolling back to the top after adding an item, now a pop up (modal) is on the shopping list view page to resolve that.

On a shopping list, you can exclude a group of items by tag from the total price. This is handy for things like personal items.

Lists have several useful calculations based on price and obtained, for example:

  • current items and total items
  • current spend, total spend and current spend percentage
  • all inclusive price (without tag price exclusions)
  • split price between flatmates OR a manual custom split override

Sometimes it can be handy to manually split instead of splitting cost by flatmates. For example if a friend external to your normal shop were to contribute to the cost on a list.

For those who use previous shopping lists as templates or a specific list as template, it has been hard to find those lists as the lists gather up over time. This bumps the lists most used as templates to the top. The more often a list is used, the further up they will appear.

(Thank you kindly to my friend Zach for helping with this feature!)

Items grouped by tag are able to be deleted by pressing on the tag then the bin icon, like so.

By default a fun confetti animation will display over the list when the complete button is pressed.

This can be turned off in 🏠 My Account ➡️ Settings ➡️ Enable Animations.

There has been a historical bug that has been fixed where the link to a templated list wouldn't navigate because under the hood it was considered the same page. See here, the page is navigated to when the link is clicked.

💳 Costs

Here's a preview of a new feature I've been recently working on.

A costs app on FlatTrack for helping keep track of spending.

A helpful graph will display the spending across the year.

Several stats to provide perspective. Of course subject to change as deemed useful.

Each entry will be displayed like a bank account ledger.

New items will be added like so:

Currently there are only four frequencies to specify how often a cost's recurrence is from the invoice day, namely: daily, weekly, fortnightly and monthly. After the amount of time is passed, it will create a new cost entry based off of the last item.

Entries will be able to be edited as needed.

Still several things to iron out, such as

  • behaviour for creating older cost

    • create range of several items all at once?
  • behaviour for editing older cost

    • update preceding items?
  • behaviour for deleting older cost

    • delete preceding items?
  • access to create new items (optional admin restriction?)

👀 Other things

A logo is coming very soon!

On a technical note:

  • vite replaced vue-build-service
  • ko.build replaced docker buildx
  • container images are now

    • multi-arch (amd64 & arm64)
    • signed with cosign, see: deployment
    • 8.7 MB on amd64 and 8.2 MB on arm64 for version 0.18.4
  • now with a scheduler for reconciling tasks in the background on the backend, more stateful tasks via reconciling data are able to now be performed by the leader
  • mkdocs replaced firn
  • it is now very fast, thanks to updating several packages, rewriting and restructuring many things
  • there is now a FlatTrack Operator for Kubernetes, built with kubebuilder.io
  • development environment can be launched now thanks to Zellij+gow+vite, using the hack/start-dev.sh script

    • auto-rebuild backend and frontend
    • several years ago, an unnecessary amount of tooling was used to provide auto-rebuild functionality. Gladly this is since removed. It had been an unfortunate barrier for contribution

🙏 Contribution

A few things that would be awesome to have visibility and assistance on include:

  • usage feedback: ticket
  • documentation

    • usage
    • development getting started
    • community
  • feature development, such as:

    • tasks: ticket
    • board: ticket
    • calendar + contacts + integration
  • migrating to Vue 3: ticket

    • cleaning up the frontend code
  • migrate to Deno from Node: ticket
  • localization (i18n): ticket

    • currency
    • time
    • translation

Please check out the project's source code, automation and issue tracker is over at 🦊 GitLab 🦊.

🛋️ Hosted

FlatTrack Hosted will be a paid solution that will be provided by islive.xyz to allow FlatTrack instances to be created and managed.

You will be able to subscribe either monthly or yearly to have a hosted FlatTrack instance.

Here's a preview.


The design and functionality is still not completely solid but will be tidier and more together soon.

Why you might like to subscribe to hosted

  • support future FlatTrack development
  • pay someone else to manage it for you
  • have the latest stable features as soon as they're available

It's targetted for release in late January.

🎁 Wrapping up

Thank you checking out this update!

Many things have progressed forward and FlatTrack is slowly becoming a more stable and mature web service.

A few new exciting things are to be released soon: costs, FlatTrack Hosted and a logo.

Looking forward to sharing further updates as things continue! 👋


Follow @flattrackio@mastodon.social! 📫


Built in New Zealand 🇳🇿