^{(Note: The image above is a mockup of what we're working towards. We're rapidly approaching the functionality shown, but not all of the parts are ready just yet.)}

Maybe: The OS for your personal finances

Get
involved: Discord • Website • Issues

If you're looking for the previous React codebase, you can find it
at maybe-finance/maybe-archive.

Backstory

We spent the better part of 2021/2022 building a personal finance + wealth
management app called, Maybe. Very full-featured, including an "Ask an Advisor"
feature which connected users with an actual CFP/CFA to help them with their
finances (all included in your subscription).

The business end of things didn't work out, and so we shut things down mid-2023.

We spent the better part of $1,000,000 building the app (employees +
contractors, data providers/services, infrastructure, etc.).

We're now reviving the product as a fully open-source project. The goal is to
let you run the app yourself, for free, and use it to manage your own finances
and eventually offer a hosted version of the app for a small monthly fee.

Maybe Hosting

There are 3 primary ways to use the Maybe app:

Managed (easiest) - coming soon...
One-click deploy
Self-host with Docker

Local Development Setup

If you are trying to self-host the Maybe app, stop here. You
should read this guide to get started.

The instructions below are for developers to get started with contributing to the app.

Requirements

Ruby 3.3.4
PostgreSQL >9.3 (ideally, latest stable version)

After cloning the repo, the basic setup commands are:

cd maybe
cp .env.local.example .env.local
bin/setup
bin/dev

# Optionally, load demo data
rake demo_data:reset

And visit http://localhost:3000 to see the app. You can use the following
credentials to log in (generated by DB seed):

Email: user@maybe.local
Password: password

For further instructions, see guides below.

Multi-currency support

If you'd like multi-currency support, there are a few extra steps to follow.

Sign up for an API key at Synth. It's a Maybe
product and the free plan is sufficient for basic multi-currency support.
Add your API key to your .env file.

Setup Guides

Dev Container (optional)

This is 100% optional and meant for devs who don't want to worry about
installing requirements manually for their platform. You can
follow this guide
to learn more about Dev Containers.

If you run into could not connect to server errors, you may need to change
your .env's DB_HOST environment variable value to db to point to the
Postgres container.

Testing Emails

In development, we use letter_opener to automatically open emails in your
browser. When an email sends locally, a new browser tab will open with a
preview.

Contributing

Before contributing, you'll likely find it helpful
to understand context and general vision/direction.

Once you've done that, please visit
our contributing guide
to get started!

Repo Activity

Copyright & license

Maybe is distributed under
an AGPLv3 license. "
Maybe" is a trademark of Maybe Finance, Inc.

winking324/maybe