1
0
Fork 0
mirror of https://github.com/maybe-finance/maybe.git synced 2025-07-18 20:59:39 +02:00
Maybe est une application web entièrement open source pour vos finances personnelles. Vous aurez à votre disposition tous les outils et calculatrices interactifs dont vous avez besoin pour visualiser et naviguer dans votre parcours financier. https://maybefinance.com/
Find a file
Zach Gollwitzer f65b93a352
Data provider simplification, tests, and documentation (#1997)
* Ignore env.test from source control

* Simplification of providers interface

* Synth tests

* Update money to use new find rates method

* Remove unused issues code

* Additional issue feature removals

* Update price data fetching and tests

* Update documentation for providers

* Security test fixes

* Fix self host test

* Update synth usage data access

* Remove AI pr schema changes
2025-03-17 11:54:53 -04:00
.cursor/rules Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
.devcontainer Bump to Ruby 3.4.1 (#1721) 2025-01-27 19:59:16 -05:00
.github Update issue templates 2025-03-05 11:01:07 -05:00
app Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
bin Handle nil name for entries (#1550) 2024-12-16 12:52:11 -05:00
config Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
db Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
docs/hosting Add DB connection troubleshooting to self hosting guide 2024-10-01 18:57:38 -04:00
lib Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
log Initial commit 2024-02-02 09:05:04 -06:00
public CSV Imports Overhaul (Transactions, Trades, Accounts, and Mint import support) (#1209) 2024-10-01 10:47:59 -04:00
storage Initial commit 2024-02-02 09:05:04 -06:00
test Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
tmp Initial commit 2024-02-02 09:05:04 -06:00
vendor Add new category flow (#1857) 2025-02-24 11:08:05 -05:00
.dockerignore Initial commit 2024-02-02 09:05:04 -06:00
.editorconfig Rubocop updates (#1118) 2024-08-23 10:06:24 -04:00
.env.example Initial pass at Plaid EU (#1555) 2025-01-31 12:13:58 -06:00
.env.local.example Initial pass at Synth-based ticker selection (#1392) 2024-10-30 09:23:44 -04:00
.env.test.example Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
.erb_lint.yml Handle nil name for entries (#1550) 2024-12-16 12:52:11 -05:00
.gitattributes Initial commit 2024-02-02 09:05:04 -06:00
.gitignore Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
.rubocop.yml Rubocop updates (#1118) 2024-08-23 10:06:24 -04:00
.ruby-version Bump to Ruby 3.4.1 (#1721) 2025-01-27 19:59:16 -05:00
biome.json Add BiomeJS for Linting and Formatting JavaScript relates to #1295 (#1299) 2024-10-14 17:09:27 -04:00
config.ru Initial commit 2024-02-02 09:05:04 -06:00
CONTRIBUTING.md Cursor rules and project design overview (#1788) 2025-02-03 19:30:03 -05:00
docker-compose.example.yml Billing (#1269) 2024-10-08 14:37:47 -05:00
Dockerfile Fix commit resolution for Docker builds 2025-03-04 07:50:21 -05:00
Gemfile Replace StackProf with Vernier for performance profiling 2025-02-25 08:37:51 -06:00
Gemfile.lock Bump stripe from 13.4.1 to 13.5.0 (#1970) 2025-03-10 09:34:15 -04:00
LICENSE Initial commit 2024-02-02 09:05:04 -06:00
package-lock.json Add BiomeJS for Linting and Formatting JavaScript relates to #1295 (#1299) 2024-10-14 17:09:27 -04:00
package.json Add BiomeJS for Linting and Formatting JavaScript relates to #1295 (#1299) 2024-10-14 17:09:27 -04:00
Procfile.dev Add post-sync UI stream updates (#1482) 2024-11-20 16:46:06 -05:00
Rakefile Initial commit 2024-02-02 09:05:04 -06:00
README.md Cursor rules and project design overview (#1788) 2025-02-03 19:30:03 -05:00
render.yaml Update render.yaml 2025-01-27 13:18:02 -05:00

dashboard_mockup (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: DiscordWebsiteIssues

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:

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

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!

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

  • See .ruby-version file for required Ruby version
  • 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.

  1. Sign up for an API key at Synth. It's a Maybe product and the free plan is sufficient for basic multi-currency support.
  2. 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.

Mac

Please visit our Mac dev setup guide.

Linux

Please visit our Linux dev setup guide.

Windows

Please visit our Windows dev setup guide.

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.

Repo Activity

Repo Activity

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