LiveDash-Node

A real-time analytics dashboard for monitoring user sessions and interactions with interactive data visualizations and detailed metrics.

Features

• Real-time Session Monitoring: Track and analyze user sessions as they happen
• Interactive Visualizations: Geographic maps, response time distributions, and more
• Advanced Analytics: Detailed metrics and insights about user behavior
• User Management: Secure authentication with role-based access control
• Customizable Dashboard: Filter and sort data based on your specific needs
• Session Details: In-depth analysis of individual user sessions

Tech Stack

• Frontend: React 19, Next.js 15, TailwindCSS 4
• Backend: Next.js API Routes, Node.js
• Database: Prisma ORM with SQLite (default), compatible with PostgreSQL
• Authentication: NextAuth.js
• Visualization: Chart.js, D3.js, React Leaflet
• Data Processing: Node-cron for scheduled tasks

Getting Started

Prerequisites

• Node.js (LTS version recommended)
• pnpm (recommended package manager)

Installation

1. Clone this repository:

git clone https://github.com/kjanat/livedash-node.git
cd livedash-node

2. Install dependencies:

pnpm install

3. Set up the database:

pnpm run prisma:generate
pnpm run prisma:migrate
pnpm run prisma:seed

4. Start the development server:

pnpm run dev

5. Open your browser and navigate to http://localhost:3000

Environment Setup

Create a .env file in the root directory with the following variables:

DATABASE_URL="file:./dev.db"
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-secret-here

Project Structure

• app/: Next.js App Router components and pages
• components/: Reusable React components
• lib/: Utility functions and shared code
• pages/: API routes and server-side code
• prisma/: Database schema and migrations
• public/: Static assets
• docs/: Project documentation

Available Scripts

• pnpm run dev: Start the development server
• pnpm run build: Build the application for production
• pnpm run start: Run the production build
• pnpm run lint: Run ESLint
• pnpm run format: Format code with Prettier
• pnpm run prisma:studio: Open Prisma Studio to view database

Contributing

1. Fork the repository
2. Create your feature branch: git checkout -b feature/my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin feature/my-new-feature
5. Submit a pull request

License

This project is not licensed for commercial use without explicit permission. Free to use for educational or personal projects.

Acknowledgments

• Next.js
• Prisma
• TailwindCSS
• Chart.js
• D3.js
• React Leaflet