OpenSubs

Track recurring bills and subscriptions 💸

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

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

Frontend

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

Nice to have

• Categorization (personal, business, services)
• Email notifications
• Web notifications

Future

• Facebook bot

License

MIT © Joaquim Adraz