AliYar-Khan / maybe-personal-finance

Personal finance and wealth management app

Home Page:https://maybe.co

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Maybe: Open-source personal finance app

Get involved: DiscordWebsiteIssues

🚨 NOTE: This is the original React/Next.js app of the now-defunct personal finance app, Maybe. This original version used many external services (Plaid, Finicity, Auth0, etc) and getting it to fully function will be a decent amount of work.

There's a LOT of work to do to get this functioning, but it should be feasible.

Features

As a personal finance + wealth management app, Maybe has a lot of features. Here's a quick overview of some of the main ones...

  • Net worth tracking
  • Financial account syncing
  • Investment benchmarking
  • Investment portfolio allocation
  • Debt insights
  • Retirement forecasting + planning
  • Investment return simulation
  • Manual account/investment tracking

And dozens upon dozens of smaller features.

Building the app

This is the current state of building the app. You'll hit errors, which we're working to resolve (and certainly welcome PRs to help with that).

You'll need Docker installed to run the app locally.

cp .env.example .env
yarn install
yarn run dev:services
yarn prisma:migrate:dev
yarn prisma:seed
yarn dev

High-priority issues

The biggest focus at the moment is on getting the app functional without some previously key external services (namely Auth0, Plaid and Finicity).

You can view the current high-priority issues here. Those are the most impactful issues to tackle first.

Relevant reading

Credit

The original app was built by Zach Gollwitzer, Nick Arciero and Tim Wilson, with design work by Justin Farrugia. The app is currently maintained by Josh Pigford.


⚠️ Everything below is archived from the original repo and we're slowly working to replace/update it.

Quick Start

System Prerequisites

  • Docker (if not using Docker, you will need Node LTS 14.7.x and Postgres 13.x)
  • (Optional, highly recommended) - Install the NX Console for using the nx client

Run the app locally

Setup ENV

cp .env.example .env

A working local development .env file can be found in 1Password under the "Engineering" folder.

With Docker (preferred)

Start server and client apps

yarn install # re-run if it hangs
yarn dev

Start Postgres & Redis Services

yarn run dev:services

Migrate DB

In a separate terminal, run the following command. This will connect to the Postgres DB running inside Docker and run all the migrations in /prisma/migrations.

yarn prisma:migrate:dev

You will also want to seed the database (includes account types and subtypes for categorization).

yarn prisma:seed

Manually

NOTE: Make sure Postgres 13.x is running on your machine

yarn install
nx serve client # Terminal 1
nx serve server # Terminal 2
yarn prisma:migrate && yarn prisma:seed # Terminal 3 - after apps are running

Reference

Authentication

See this wiki page for an explanation of how authentication/authorization works in this codebase.

About

Personal finance and wealth management app

https://maybe.co

License:GNU Affero General Public License v3.0


Languages

Language:TypeScript 94.0%Language:HTML 2.9%Language:PLpgSQL 1.3%Language:JavaScript 1.0%Language:Shell 0.3%Language:CSS 0.2%Language:MDX 0.2%Language:EJS 0.1%Language:Dockerfile 0.1%