RealTimeComms Platform

📌 System Overview

A cutting-edge, instant messaging client engineered using Next.js, Prisma for data persistence, and NextAuth.js for robust access control. This solution delivers secured user sign-in and low-latency message exchange within a modern, adaptable user interface.

✨ Key Capabilities

Instantaneous message propagation
Secure authentication powered by NextAuth.js (Email flow focused)
Persistent data storage leveraging SQLite managed via Prisma ORM
Fluid, device-agnostic presentation layer achieved with Tailwind CSS

🚀 Deployment Guide

Prerequisites

Runtime Environment: Node.js (Version 14 or greater recommended)
Package Manager: npm or yarn
[Any additional system requirements]

Setup Instructions

Obtain the source code repository: bash git clone https://github.com/WebChatAppAi/webchat.git cd webchat
Resolve dependencies: bash npm install # Alternative package manager command: yarn install
Establish the configuration context file (.env) in the root directory, populating required secrets:

# Database Connection Details DATABASE_URL="file:./dev.db"

# Security Token for Authentication (Crucial: Generate a fresh 32-byte base64 secret) NEXTAUTH_SECRET="your_secure_random_secret_key" NEXTAUTH_URL="http://localhost:3000" # Update this for production environment targeting

# SMTP Configuration for Credential Delivery (If not using mock provider) EMAIL_SERVER_HOST="smtp.your-service-provider.com" EMAIL_SERVER_PORT="465" EMAIL_SERVER_USER="sender@your-domain.com" EMAIL_SERVER_PASSWORD="smtp_access_password" EMAIL_FROM="noreply@your-domain.com"

Initiate the local development server: bash npm run dev # Alternative command: yarn dev

🛠️ Technology Stack

Application Core: Next.js 14 (Utilizing the App Router paradigm)
Programming Language: TypeScript
Data Layer: SQLite integrated with Prisma Object-Relational Mapper
Identity Management: NextAuth.js
Visual Styling: TailwindCSS utility framework
UI Primitives: Shadcn UI components

📋 Source Code Layout

webchat/ ├── prisma/ # Schema definitions and database migration scripts ├── public/ # Static media assets ├── src/ # Primary application source code │ ├── app/ # App Router segments (pages, layouts, routes) │ ├── components/ # Reusable view elements │ └── lib/ # Auxiliary modules and system configurations ├── .env # Runtime environment variables (should be excluded from version control) ├── .gitignore # Rules defining untracked files ├── next.config.ts # Custom settings for the Next.js build process └── README.md # Documentation file