Overview
VizBoard is built with modern, production-ready technologies focused on type safety, developer experience, and performance.Core Framework
Next.js
Version: 15.3.2
- App Router architecture
- Server Components
- Server Actions
- Turbopack for fast builds
- Built-in optimizations
React
Version: 19.0.0
- Latest features
- Server Components
- Improved hydration
- Concurrent rendering
- Automatic batching
TypeScript
Version: 5.8.3
- Full type safety
- Enhanced IDE support
- Compile-time error checking
- Better refactoring
Node.js
Runtime environment
- ESM module support
- Crypto for encryption
- Environment variables
Database & ORM
Prisma ORM
Prisma Client - v6.8.2
Prisma Client - v6.8.2
Purpose: Application database operationsFeatures:
- Auto-generated type-safe client
- Schema migrations
- Connection pooling
- Transaction support
- Relation loading
PostgreSQL
Primary database for storing:- User accounts and authentication
- Projects and configurations
- Widget definitions
- Encrypted connection credentials
- Cached database schemas
Knex.js
Knex Query Builder - v3.1.0
Knex Query Builder - v3.1.0
Purpose: External database connectionsFeatures:
- Multiple database support
- Query building
- Transaction management
- Connection pooling
Knex Schema Inspector
Schema Introspection - v3.1.0
Schema Introspection - v3.1.0
Purpose: Discover database structureUsed for:
- Table discovery
- Column metadata
- Primary keys
- Foreign key relationships
- Data types
Authentication
NextAuth.js
NextAuth.js v5.0.0-beta.28
Features:
- JWT-based sessions
- Multiple providers
- Prisma adapter
- TypeScript support
- Custom callbacks
- Google OAuth
- GitHub OAuth
- Email/Password (Credentials)
Password Hashing
bcryptjs - v3.0.2
bcryptjs - v3.0.2
UI Framework & Components
Styling
Tailwind CSS
Version: 4.x
- Utility-first CSS
- JIT compilation
- Custom design system
- Dark mode support
- PostCSS integration
CSS Utilities
class-variance-authority - v0.7.1
Component variantstailwind-merge - v3.3.0
Merge Tailwind classesclsx - v2.1.1
Conditional classes
Component variantstailwind-merge - v3.3.0
Merge Tailwind classesclsx - v2.1.1
Conditional classes
Radix UI Primitives
Headless, accessible UI components:Radix UI Components
Radix UI Components
- Fully accessible (ARIA)
- Unstyled by default
- Composable primitives
- TypeScript support
- Keyboard navigation
Icons
Lucide React
Version: 0.511.0
- 1000+ icons
- Tree-shakeable
- Consistent design
- Lightweight SVGs
Tabler Icons
Version: 3.33.0
- Additional icon set
- Consistent stroke width
- Outlined style
- React components
Theme Support
next-themes - v0.4.6
next-themes - v0.4.6
- System theme detection
- Persistent preference
- No flash on load
- Class or data-attribute
Data Visualization
Recharts
Recharts - v2.15.3
Composable charting library for ReactSupported Charts:
- Bar charts
- Line charts
- Area charts
- Composed charts
- Responsive
- Customizable
- SVG-based
- Animations
- Tooltips
TanStack Table
@tanstack/react-table - v8.21.3
@tanstack/react-table - v8.21.3
Headless table libraryFeatures:
- Sorting (multi-column)
- Filtering (global & column)
- Pagination
- Row selection
- Column visibility
- Resizing
- Type-safe
- Headless (bring your own UI)
State Management
Zustand
Zustand - v5.0.5
Lightweight state managementWhy Zustand?
- Simple API
- No boilerplate
- TypeScript support
- DevTools integration
- Middleware support
- Persistence plugin
- Widget dialog state
- Project draft persistence
- UI preferences
SWR
SWR - v2.3.3
SWR - v2.3.3
Data fetching and cachingFeatures:
- Automatic revalidation
- Cache management
- Optimistic updates
- Pagination support
- Error retry
- Focus revalidation
- Interval polling
- Projects list
- Dashboard data
- Widget configurations
- Real-time updates
Form Handling
React Hook Form
react-hook-form - v7.56.4
- Minimal re-renders
- Built-in validation
- Zod integration
- Error handling
- TypeScript support
- Project creation/editing
- Database connection forms
- Widget configuration
- User settings
Validation
Zod
Zod - v3.25.42
Zod - v3.25.42
TypeScript-first schema validationBenefits:
- Type inference
- Composable schemas
- Custom error messages
- Transform data
- Runtime validation
UI Enhancements
Animation & Interaction
Framer Motion
Version: 12.19.2
- Smooth animations
- Gesture handling
- Layout animations
- Spring physics
DnD Kit
Version: 6.3.1
- Drag and drop
- Sortable lists
- Touch support
- Accessibility
- Widget reordering
- Dashboard layout
Additional UI Libraries
UI Component Libraries
UI Component Libraries
Sonner - v2.0.4
Toast notificationsVaul - v1.1.2
Drawer component for mobilereact-resizable-panels - v3.0.2
Resizable panel layoutsreact-day-picker - v9.7.0
Date picker componentinput-otp - v1.4.2
OTP input fields
Toast notifications
Drawer component for mobilereact-resizable-panels - v3.0.2
Resizable panel layoutsreact-day-picker - v9.7.0
Date picker componentinput-otp - v1.4.2
OTP input fields
Utilities
Date & Time
date-fns - v4.1.0
date-fns - v4.1.0
- Modular (tree-shakeable)
- Immutable
- TypeScript support
- Locale support
Other Utilities
Security
Encryption
Node.js Crypto (Built-in)
Node.js Crypto (Built-in)
- Database connection credentials
- Sensitive configuration
- AES-256-GCM encryption
- Authentication tags for integrity
Development Tools
Build & Dev Tools
Turbopack
Next.js 15 bundler
- Fast incremental builds
- Optimized for Next.js
- Built in Rust
ESLint
Version: 9.x
- Code quality
- Next.js rules
- TypeScript support
TypeScript
Version: 5.8.3
- Type checking
- IntelliSense
- Refactoring support
ts-prune
Version: 0.10.3
- Find unused exports
- Dead code detection
Database Tools
Prisma CLI & Tools
Prisma CLI & Tools
prisma - v6.8.2
Prisma development toolsts-node - v10.9.2
Run TypeScript directly for seedingtsx - v4.19.4
Fast TypeScript execution
Prisma development tools
Run TypeScript directly for seedingtsx - v4.19.4
Fast TypeScript execution
Test Data Generation
@faker-js/faker - v9.9.0
@faker-js/faker - v9.9.0
- Database seeding scripts
- Test data generation
- Sample dashboards
Package Management
package.json
VizBoard uses ESM modules (
"type": "module") for modern JavaScript features and better tree-shaking.Scripts
Environment Variables
Required Environment Variables
Required Environment Variables
.env
Deployment Considerations
Vercel
Recommended Platform
- Native Next.js support
- Edge functions
- Automatic HTTPS
- Preview deployments
- Environment variables
Docker
Self-Hosted Option
- Included docker-compose.yml
- PostgreSQL containers
- Database seeding
- Volume persistence
All production dependencies are carefully selected for stability, active maintenance, and TypeScript support.
