Application Notes

Services

Banchan uses the following third-party services as part of its development and deployment:

• GitHub - Code hosting, project management
• Fly.io - Platform + database hosting and clustering
• Amazon S3 - File/image uploads storage
• Plausible - Web analytics
• Netlify - Landing page hosting, beta signup email form collection
• Stripe - Stripe Connect Express with Stripe Tax for payment processing and tax management
• Sendgrid - Sending emails (both transactional and marketing)
• Sentry.io(?) - (planned?) Logging and error logging
• Google - OAuth login
• Discord - OAuth login
• Twitter - OAuth login

Services Wishlist

Stuff we don't use yet, but might be nice to afford in the future:

• Zendesk - Support tickets, although we might be able to just build our own?
• Oban Web - Better observability into Oban queues. Kinda pricey for what we get, though.

Working with Stripe

In order to create studios and test transactions locally, you need to create your own Stripe account. The country must be set to the United States, since that's what Banchan currently expects and it's not configurable. It needs to have Stripe Tax activated. You'll also need to install and run the Stripe CLI.

Stripe has a number of credit card and account numbers for testing.

Of note:

• 4000000000000077: Instantly succeeds a payment, bypassing the pending period (so the amount can be immediately paid out)
• 4000000000000002: Card declined
• 4242424242424242: US-based transaction that immediately succeeds but is subject to the payout waiting period (7 days for an account's first payout, even in test mode)

Environment Variables

There's a number of env vars you need to get set up to get up and running, depending on your needs/environment. See Environment Variables.

Details to Know

• Phoenix templates are not in used due to incompatibilities with SurfaceUI.
• router.ex to view all URLs and their routes
• priv/repo/migrations/ and lib/banchan/ for database schema and migrations

Dependencies of Note

Automatically installed as part of the initial install of the repo, here are a few dependencies to be aware of that the project is built on:

• Phoenix
• Phoenix LiveView
• SurfaceUI
• TailwindCSS
• DaisyUI