Docs

The practical guide to how SupportIQ is wired.

A quick reference for the current app architecture, deployment model, and backend integration points.

Open DashboardCreate Ticket

Deployment architecture

SupportIQ is a full-stack Next.js app deployed on Vercel. Server Actions act as backend functions inside the same app.

DynamoDB storage

Tickets, users, sessions, notifications, and workspace settings are stored in DynamoDB tables: SupportIQTickets, SupportIQUsers, SupportIQSessions, SupportIQNotifications, and SupportIQSettings.

Important files

Backend integration lives in lib/dynamodb.ts, lib/ticket-actions.ts, lib/classify-ticket.ts, and lib/types.ts.

Environment variables

AWS_REGION, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, DYNAMODB_TABLE_NAME, DYNAMODB_USERS_TABLE_NAME, DYNAMODB_SESSIONS_TABLE_NAME, DYNAMODB_NOTIFICATIONS_TABLE_NAME, and DYNAMODB_SETTINGS_TABLE_NAME must be configured in Vercel. Never expose them as NEXT_PUBLIC values.