OpenSubs

Track recurring bills and subscriptions :money_with_wings:

Things I wrote about the project:

• Guide to deploy an Elixir/Phoenix app to AWS ECS

Stack

• Elixir backend
• React frontend
• PostgreSQL database

How to run OpenSubs

1. mix deps.get, to install dependencies
2. mix ecto.setup, to create and migrate the database
3. cd apps/subs_web/frontend && yarn install, to install frontend dependencies
4. mix phx.server, to run the server, will also build the frontend

• cd apps/subs_web/frontend && node_modules/.bin/webpack --config webpack.config.js, to build the frontend manually

View sent emails in the development environment

The Bamboo.LocalAdapter is used in :dev mode. To see emails that have been sent, visit the following URL:

http://0.0.0.0:4000/sent_emails

Running tests

• brew install chromedriver, to run acceptance tests
• mix test, to un all tests
• mix test --only acceptance, to run only acceptance tests

MVP

Backend API

• [x] User signup/authentication
• [x] User password recovery
• [x] Services list
• [x] Subscriptions create
• [x] Subscriptions update
• [x] Subscriptions archive
• [x] Subscriptions list

Frontend

• [x] User signup/authentication
• [x] User password recovery
• [x] Create custom subscription
  • [x] Create from service service
• [x] List all subscriptions
• [x] Subscriptions dashboard
  • [x] Due this month
  • [x] Due next month
  • [x] Monthly payment
  • [x] Yearly payment

Nice to have

• [ ] Categorization (personal, business, services)
• [x] Email notifications
• [ ] Web notifications

Future

• [ ] Facebook bot

License

MIT © Joaquim Adraz