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 (nextjs.org) React framework for server-side rendering, server actions, and API routes.
Shadcn/ui (github.com/shadcn/ui) Component library built on Radix and Tailwind CSS.
Tailwind CSS (tailwindcss.com)
Utility-first styling for rapid UI development.lucide-react (lucide.dev) Icon library used for UI embellishments.
React Flow (reactflow.dev) Library for building interactive node-based UIs and flow diagrams.
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.org) Relational database; JSONB support and PL/pgSQL power the in-database process engine. Also used for realtime via
LISTEN/NOTIFY.PL/pgSQL (postgresql.org/docs) Procedural language for stored functions and triggers that drive workflow execution.
Prisma (prisma.io) ORM for type-safe database access. Schema in
prisma/schema.prisma, generated client inlib/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 & Server Actions (nextjs.org) Server-side logic, API endpoints, and database mutations.
- SSE (Server-Sent Events)
Used for realtime updates — backed by PostgreSQL
LISTEN/NOTIFYvia a persistentpgconnection and streamed to clients through/api/realtime.
Containerization & CI/CD
Docker (docker.com) Container platform for packaging and running the application.
Docker Compose (docs.docker.com/compose) Define and manage multi-container deployments (app + database + activity services).
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 (hub.docker.com) Public registry for hosting Docker images.
Automation & Routing
Watchtower (containrrr.dev/watchtower) Monitors Docker Hub and updates running containers automatically when a new image is pushed.
Traefik (traefik.io) Dynamic edge router and load balancer with automatic SSL via Let's Encrypt.
Hosting & Infrastructure
Ubuntu Server (ubuntu.com)
Linux distribution used for the production host (Hetzner VPS).