/
Development Workflow and Deployment

Development Workflow and Deployment

The structure of Planner’s development workflows and its deployment from top to bottom.

Workflows and Previews

In development, a personal Neon DB and local instance of the validator should be used. When a pull request is opened, the preview workflow will trigger the creation of a Neon branch (TLDR: a copy-on-write clone of the prod DB) and trigger a Vercel preview for said PR. When a PR is merged/closed, the preview's Neon branch is deleted.

It is possible to trigger a branch deletion before the creation is complete (a branch is opened then merged/close immediately). In this case, the branch might need to be manually deleted.

Relevant files:

Deployments

The staging deployment, https://dev.planner.utdnebula.com , deploys off the develop branch, and the production deployment deploys off of main.

All deployment/external services:

  • Web server: Vercel

  • TRPC Routes: Vercel serverless functions

  • Planner Postgres: Neon

  • Umami (User analytics): Railway

  • Umami Postgres: Railway

  • Sentry (Error logging/crash analytics)

  • Auth Providers: Discord, Google, Facebook

  • Mailtrap (Email "magic link" auth)