Eridu Services

TLDR: A TypeScript monorepo for live-commerce broadcast operations. erify_api (NestJS) manages shows, schedules, tasks, and users. eridu_auth (Better Auth) handles SSO. erify_creators and erify_studios (React/Vite) are the frontend apps. Shared packages provide type-safe API contracts, auth SDK, UI components, and i18n.

Architecture

graph TB
    subgraph Frontend["Frontend Apps"]
        creators["erify_creators<br/><i>React · Vite · TanStack Router</i><br/>Show management for creators"]
        studios["erify_studios<br/><i>React · Vite · TanStack Router</i><br/>Studio admin & task management"]
    end

    subgraph Backend["Backend Services"]
        api["erify_api<br/><i>NestJS · Prisma · PostgreSQL</i><br/>REST API for all operations"]
        auth["eridu_auth<br/><i>Better Auth · PostgreSQL</i><br/>SSO & JWT authentication"]
    end

    subgraph Packages["Shared Packages"]
        types["@eridu/api-types<br/><i>Zod schemas & TS types</i>"]
        sdk["@eridu/auth-sdk<br/><i>JWT/JWKS validation</i>"]
        ui["@eridu/ui<br/><i>shadcn/ui components</i>"]
        i18n["@eridu/i18n<br/><i>Translations (EN/ZH-TW/TH)</i>"]
    end

    subgraph External["External Integrations"]
        gs["Google Sheets<br/><i>Apps Script</i><br/>Schedule planning"]
    end

    creators --> api
    studios --> api
    creators --> auth
    studios --> auth
    api --> auth
    gs --> api

    creators -.-> types & sdk & ui & i18n
    studios -.-> types & sdk & ui & i18n
    api -.-> types & sdk

    style Frontend fill:#e8f4fd,stroke:#2196F3
    style Backend fill:#fff3e0,stroke:#FF9800
    style Packages fill:#e8f5e9,stroke:#4CAF50
    style External fill:#f3e5f5,stroke:#9C27B0

Apps

erify_api - REST API service built with NestJS for managing shows, schedules, tasks, users, and related entities
eridu_auth - Better Auth service for SSO across all services in the monorepo
erify_creators - React application for managing shows, built with TanStack Router, TypeScript, and Vite
erify_studios - React application for studio admin, task management, and scheduling, built with TanStack Router, TypeScript, and Vite

Authentication service

generate auth db schema for drizzle pnpm auth:schema
generate sql migration for database pnpm db:generate
migrate auth schema to db pnpm db:migrate

Packages

@eridu/api-types - Shared API type definitions and Zod schemas
@eridu/auth-sdk - Authentication SDK for JWT validation and JWKS management
@eridu/eslint-config - Shared ESLint base configuration
@eridu/i18n - Shared internationalization translations and locale utilities
@eridu/typescript-config - Shared TypeScript base configuration
@eridu/ui - Shared UI components with shadcn/ui

to-dos

setup semantic versioning
setup docker-compose for related services
Optimize eslint settings for editor
setup husky commit hooks
- eslint before commit
- sherif before commit
- commitlint before commit
setup vitest for unit tests
- erify_creators app
setup CI
- Github actions

Git Hooks

This monorepo uses husky to manage Git hooks and ensure code quality before commits.

Pre-commit Hook

The pre-commit hook runs automatically before each commit and executes:

ESLint - Lints all code across the monorepo using pnpm lint
Sherif - Checks that dependency versions are aligned across all packages using pnpm sherif

If any of these checks fail, the commit will be blocked.

Commit Message Hook

The commit-msg hook validates commit messages using commitlint with the Conventional Commits format.

Commit messages must follow the format:

<type>(<scope>): <subject>

Examples:

feat: add new authentication endpoint
fix(api): resolve schedule validation bug
chore: update dependencies

Valid types: feat, fix, docs, style, refactor, perf, test, chore, ci, build, revert

Setup

Husky is automatically initialized when you run pnpm install (via the prepare script). The hooks are located in .husky/ directory.

Utilities

sherif to check if the same dependencies are in the same version across monorepo.

# check dependency versions in the mono repo
pnpm sherif

# fix and install dependencies in aligned versions
pnpm sherif --fix

# fix dependencies in aligned versions without install
pnpm sherif --fix --no-install

Build

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

pnpm build

Develop

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

pnpm dev

Test

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

pnpm test

Name	shared-api-types
Description	Provides guidelines for using keys, schemas, and types from the shared @eridu/api-types package. This skill should be used when defining API contracts, ensuring type safety between frontend and backend, or implementing Zod schemas.

shared-api-types

SKILL.md