Skip to main content

Web UI Tech Stack

The Permission Manager Web UI is a Next.js 15 application with TypeScript and Tailwind CSS.

Core Stack​

LayerTechnologyVersion
FrameworkNext.js (App Router)16
LanguageTypeScript5.7 (strict mode)
UI LibraryReact19
StylingTailwind CSS4
ChartsRecharts3
Authiron-session8
Config Parsingjs-yaml4
ValidationZod4
Notificationssonner1
Iconslucide-react1

Dev Tooling​

ToolPurpose
ESLintLinting (eslint.config.mjs)
VitestUnit testing
Testing LibraryComponent testing
TypeScriptStatic type checking (tsc --noEmit)
PostCSSCSS processing (Tailwind v4 plugin)

Design Decisions​

App Router (Not Pages Router)​

Next.js App Router was chosen for:

  • Server Components by default (reduced client JS)
  • Nested layouts and loading states
  • Route groups for API organization
  • Middleware for auth guarding

Client-Side Rendering​

The Web UI uses "use client" directives extensively because:

  • Session state is client-side (cookie)
  • Real-time config editing needs reactive UI
  • Charts (Recharts) require browser APIs
  • No SSR benefit for an admin dashboard behind auth

Dark Theme Only​

The UI uses a dark color scheme exclusively (bg-gray-900, text-gray-100). There's no light mode toggle. This keeps the design simple and focused on the server management use case.

Standalone Output​

The Dockerfile uses Next.js standalone output mode for minimal production images:

# Build stage
FROM node:22-alpine AS builder
RUN npm run build # produces .next/standalone/

# Production stage
FROM node:22-alpine
COPY --from=builder /app/.next/standalone ./
CMD ["node", "server.js"]