-
Clone & Setup:
git clone https://github.com/vinhnx/vtchat.git cd vtchat cp apps/web/.env.example apps/web/.env.local -
Configure Environment:
- Generate
BETTER_AUTH_SECRET:node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" - Add your AI API key (OpenAI, Anthropic, or Gemini)
- Edit
apps/web/.env.local
- Generate
-
Run with Docker:
./validate-setup.sh # Optional: validate configuration docker-compose up --build -
Access: http://localhost:3000
That's it! Full VT instance with PostgreSQL, hot reload, and all features.
See Local Development Setup for manual installation.
VT is a production-ready, privacy-focused AI chat application with security and comprehensive AI capabilities. This documentation provides complete guides for deployment, development, and feature implementation.
- Live Application: vtchat.io.vn
- Features: Complete Feature List
- Help Center: help-center/
- Architecture: System Architecture Overview
- Development Guidelines: ../AGENT.md
- Local Setup: local-development-setup.md
- Production Deployment: DEPLOYMENT.md
- Production Checklist: production-deployment-checklist.md
- Fly.io Guide: fly-deployment-guide.md
- Features Overview - Complete feature list and capabilities
- Architecture - System design and technology stack
- Security Guide - Comprehensive security implementation
- Deployment Guide - Production deployment instructions
- Final Release Notes - v1.0 production achievements
- Database Setup - Database configuration and migrations
- Local Development - Development environment setup
- Testing Setup - Comprehensive testing framework
- Performance Report - Production readiness metrics
- Arcjet Security - Application security implementation
- Logging Best Practices - Structured logging with PII redaction
- Privacy Monitoring - Privacy-safe analytics approach
- Subscription System - Plan management and feature gating
- Creem.io Webhook Setup - Payment webhook configuration
- OAuth Setup - Authentication provider configuration
- Shadcn UI Migration - Complete design system integration
- Theming Update - Global theming implementation
- UI Audit Report - User interface improvements
- Reasoning Mode - AI reasoning capabilities
- Document Upload - File processing features
- Structured Output - JSON extraction capabilities
- Image Generation - UI, AR behavior, and API flow
- Vitest Setup - Modern testing configuration
- Testing Strategies - Feature-specific testing approaches
- Performance Testing - Performance validation
- Production Readiness: 95% complete with comprehensive quality checks
- Zero TypeScript Errors: Full type safety maintained
- Performance Optimized: 87% faster compilation, optimized bundle size
- Complete AI Integration: Multi-provider support with reasoning mode
- Security Hardened: Arcjet protection with Better Auth integration
- Payment Processing: Creem.io integration with customer portal
- Performance Optimized: 87% faster builds, optimized database queries
- Mobile Responsive: Complete Shadcn UI integration
| Metric | Before | After | Improvement |
|---|---|---|---|
| Bundle Size | 456kB | 436kB | -4.4% |
| Compilation Speed | 24s | 3s | -87% |
| Auth Performance | Baseline | +87% | 87% faster |
| Database Queries | Baseline | +75% | 70-80% faster |
- Access to a suite of 9 free AI models, including 5 from the Gemini family (2.5 Flash Lite, 2.5 Flash, 2.5 Pro) and 4 from OpenRouter.
- Advanced calculator with mathematical functions
- Local-first privacy with IndexedDB storage
- security protection
- Basic chat functionality
- All free features included
- Reasoning Mode: AI thinking process transparency
- Dark Theme: Premium theming experience
- Web Search: Real-time information grounding
- Document Upload: PDF/DOC/DOCX processing up to 10MB
- Structured Extraction: AI-powered JSON data extraction
- Frontend: Next.js 15 (App Router), React 19.0.0, TypeScript, Tailwind CSS, Shadcn UI
- State: Zustand + React Query for optimal state management
- Backend: Bun runtime, Neon PostgreSQL, Drizzle ORM
- Auth: Better Auth with 87% performance improvement
- Security: Arcjet protection (rate limiting, bot detection, WAF)
- Deployment: Fly.io with Singapore region optimization
- Local Storage: All chat data in browser IndexedDB, never on servers
- Zero Persistence: Conversations never leave user's device
- Thread Isolation: Complete data separation between users
- GDPR Compliant: Privacy-by-design architecture
- Arcjet Security - Comprehensive security setup
- Logging Best Practices - Structured logging with Pino
- Premium Components - VT+ exclusive features
- Production Monitoring - Error tracking and metrics
- DNS Configuration - Domain setup guide
- Fly.io Optimization - Performance tuning
- Bun Documentation - JavaScript runtime and package manager
- Turborepo Guide - Monorepo management
- Next.js 15 Docs - App Router and React Server Components
- Better Auth - Modern authentication
- Arcjet - Application security platform
- Creem.io - Payment processing
- Neon - Serverless PostgreSQL
- Help Center: help-center/ - User guides and FAQ
- Privacy Policy: Privacy-first approach documentation
- Feature Requests: Feedback and improvement suggestions
- Development Guidelines: ../AGENT.md
- Issue Tracking: GitHub issues and pull requests
- Security Reports: Responsible disclosure process
Status: ✅ Production Ready | Version: v1.0 | Last Updated: June 30, 2025
VT (VTChat) represents a complete, production-ready AI chat application that prioritizes user privacy while delivering cutting-edge AI capabilities through an intuitive, modern interface.
- Self-Hosting Guide - Complete Docker & manual setup
- Quick Docker setup (above)
- Manual installation guides
- Configuration troubleshooting
- Feature customization