ToBeIT67

This is a monorepo for most of the services (exclude discord bot) used in the event.

What's inside?

This turborepo uses pnpm as a package manager. It includes the following packages/apps:

Apps and Packages

• cms: a content management system, used as a tool for configuring the details of the service. e.g. seat reservation, blogs
• home: a Next.js app, deployed on vercel as a landing page and dashboard for participants.
• regis: a Nest.js backend which uses GraphQL and Prisma.

Each package/app is 100% TypeScript.

Utilities

This turborepo has some additional tools already setup for you:

• TypeScript for static type checking

Prerequisite

Here are all technologies those are required to develop and build:

• Node js 16
• pnpm
• Docker
• Firebase Project

Services used

Here are all services used in this app (runs on Docker):

• postgres
• uptime-kuma
• pgbouncer
• Strapi CMS (only when running pnpm run compose:prod)

Presetup & Environment Variables

Run the following command to copy the .env.example to .env.template:

pnpm presetup

Optionally, once done with editing the template file, run this command to distribute them to the apps:

pnpm setup:env

Setup

To setup all apps and packages, run the following command:

pnpm run setup

Commands related to composing Docker containers

To develop all apps and packages, run the following command:

• pnpm run compose:dev compose every services excepted for cms
• pnpm run compose:prod compose every services including cms (app)

Commands related to Prisma

To develop all apps and packages, run the following command:

• pnpm run db:migrate migrate regis prisma
• pnpm run db:generate generaate regis prisma

Remote Caching

Turborepo can use a technique known as Remote Caching to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.

By default, Turborepo will cache locally. To enable Remote Caching you will need an account with Vercel. If you don't have an account you can create one, then enter the following commands:

cd my-turborepo
pnpm dlx turbo login

This will authenticate the Turborepo CLI with your Vercel account.

Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your turborepo:

pnpm dlx turbo link

Useful Links

Learn more about the power of Turborepo:

• Pipelines
• Caching
• Remote Caching
• Scoped Tasks
• Configuration Options
• CLI Usage