DEPLOYMENT.md

Deployment

Cella makes it easy to deploy on Render (server & db, frontend) and with Cloudflare for a proxy. Probably more options will become available over time.

Deploy backend and frontend to render.com

Go to blueprints and select the repo by clicking Connect.

Speed up the process by using the existing render.yaml file in the root. All deployed PRs will use the onrender.com domain.

Deploy Cloudflare Proxy

To run Cella on one domain in production we proxy traffic without touching Cella itself. This way certificates are handled automatically, and you end up with your application on root {domain}/ and the API running on the same domain using {domain}/api/v1/.

Add your site in Cloudflare, you will need to be able to manage its DNS records.

Update BACKEND_RENDER_URL and FRONTEND_RENDER_URL in proxy/wrangler.toml to what the results are from the previous step, and configure your custom domain accordingly.

Now run pnpm run proxy:deploy and follow the steps from there.

Enable Novu Slack notification

Gide by Novu. At first, create App in Slack so you can obtain the App ID, Client ID, and Client Secret.

Then, create Novu Workflow and select 'Blank workflow'.

The next step is creating the Slack integration. Create a Slack provider and add the App ID, Client ID, and Client Secret obtained from the first step. It's important not to forget to activate it. Now, in the workflow, add the 'Chat (Slack)' option to your workflow trigger and configure the message content. Pass variables that you want to use within double curly braces as example {{usersMessage}}.

Also we need to add incoming webhook.

Now, let's create the backend. Install the package.

pnpm install @novu/node

Create notification sender

import { Novu, ChatProviderIdEnum } from '@novu/node';

const notification = (message: string) => {
    const novu = new Novu(env.NOVU_API_KEY);

    // Identify the subscriber, an entity designed to receive notifications. If there is no subscriber with such an ID, create one; otherwise, use the existing one.
    await novu.subscribers.identify('Subscriber identifier', {
        firstName: 'John',
        lastName: 'Bridgenton',
        email: '[email protected]',
    });

    // Set's notification to chosen channel
      await novu.subscribers.setCredentials('Subscriber identifier', ChatProviderIdEnum.Slack, {
        webhookUrl: 'Webhook that you have created',
      });

    // Send the notification 
    novu.trigger('Your workflow name(default 'untitled')', {
        to: {
        subscriberId: 'Subscriber identifier',
        },

        // In the payload, you need to include the variables that you declared in the workflow trigger's message content.
        payload: {
            usersMessage: message,
        },
    });
}