/sample-saas

A simple multi tenant notes app for demonstrating integration with Bunny

Primary LanguageJavaScriptMIT LicenseMIT

Sample-SaaS

A simple multi tenant notes app for demonstrating integration with Bunny.

The sample is built using Node + Express + Tailwind CSS.

What does it do?

Sign in/sign up is email address. There are no passwords or magic links. This is just a demo app so we're not focussed on account security in this case.

  • If you sign up for a new account at /accounts/sign-up it will

    • create a new tenant/account in sample-saas
    • create a new account & subscription in Bunny
    • set the local account.id as the tenantCode for this account in Bunny

  • If you select "Manage Subscription" in the top menu it will redirect you to Bunny's subscription management portal where you can upgrade or modify subscriptions, and make payments etc.

  • When a webhook is recieved from Bunny at /api/hook it will

    • validate the incoming webhook signature from the request header using a shared signing token
    • check if the tenant in the webhook payload matches with any accounts store locally.
      • if no account is found it will create one and set the max notes allowance
      • if an account is found it will update the max notes allowance for that account

Setup

Refer to https://docs.bunny.com/developer/integrate/the-sample-saas-app for instructions

Develop

Run this sample in development mode which will auto rebuild on changes.

Start the main express app.

> npm install
> npm run dev

If you want to make changes to html templates and css then also run the css rebuild using

> npm run build-css

Then access the sample at http://localhost:3030

Beware

This is a simple app designed to demonstrate how Bunny can be used with a SaaS application. Feel free to copy how we have used the Bunny SDK but take note that we have made compromises in order to keep this simple so please don't copy the app itself, user management and session security etc.