Architecture

    Tech Stack

    Overview of technologies and services used in ProcessFlow with links, icons, and brief descriptions.

    Tech Stack Overview

    A concise list of the core technologies and services powering ProcessFlow, complete with official links and icons for easy reference.


    Frontend

    • Next.js Next.js (nextjs.org) React framework for server-side rendering, server actions, and API routes.
    • Shadcn/ui Shadcn/ui (github.com/shadcn/ui) Component library built on Radix and Tailwind CSS.
    • Tailwind CSS Tailwind CSS (tailwindcss.com) Utility-first styling for rapid UI development.
    • lucide-react lucide-react (lucide.dev) Icon library used for UI embellishments.
    • React Flow React Flow (reactflow.dev) Library for building interactive node-based UIs and flow diagrams.
    • Zustand Zustand (zustand-demo.pmnd.rs) Lightweight state management for React.
    • Framer Motion (framer.com/motion) Animation library for smooth UI transitions.
    • Recharts (recharts.org) Composable charting library used for gamification statistics.
    • next-intl (next-intl.dev) Internationalization for Next.js with server and client component support.
    • Fumadocs (fumadocs.vercel.app) Documentation framework integrated directly into the Next.js app.

    Backend & Database

    • PostgreSQL PostgreSQL (postgresql.org) Relational database; JSONB support and PL/pgSQL power the in-database process engine. Also used for realtime via LISTEN/NOTIFY.
    • PL/pgSQL PL/pgSQL (postgresql.org/docs) Procedural language for stored functions and triggers that drive workflow execution.
    • Prisma Prisma (prisma.io) ORM for type-safe database access. Schema in prisma/schema.prisma, generated client in lib/generated/prisma.
    • better-auth (better-auth.com) Authentication library handling email/password sign-up and sign-in, session management, and custom user fields.
    • Next.js API Routes Next.js API Routes & Server Actions (nextjs.org) Server-side logic, API endpoints, and database mutations.
    • SSE (Server-Sent Events) Used for realtime updates — backed by PostgreSQL LISTEN/NOTIFY via a persistent pg connection and streamed to clients through /api/realtime.

    Containerization & CI/CD

    • Docker Docker (docker.com) Container platform for packaging and running the application.
    • Docker Compose Docker Compose (docs.docker.com/compose) Define and manage multi-container deployments (app + database + activity services).
    • GitHub Actions GitHub Actions (github.com/features/actions) CI/CD workflow: builds and pushes the Docker image to Docker Hub on every push to main.
    • Docker Hub Docker Hub (hub.docker.com) Public registry for hosting Docker images.

    Automation & Routing

    • Watchtower Watchtower (containrrr.dev/watchtower) Monitors Docker Hub and updates running containers automatically when a new image is pushed.
    • Traefik Traefik (traefik.io) Dynamic edge router and load balancer with automatic SSL via Let's Encrypt.

    Hosting & Infrastructure

    • Ubuntu Server Ubuntu Server (ubuntu.com) Linux distribution used for the production host (Hetzner VPS).

    On this page

    Tech Stack