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)
• npm or yarn

Installation

1. Clone this repository:

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

2. Install dependencies:

   npm install

3. Set up the database:

   npm run prisma:generate
   npm run prisma:migrate
   npm run prisma:seed

4. Start the development server:

   npm 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

• npm run dev: Start the development server
• npm run build: Build the application for production
• npm run start: Run the production build
• npm run lint: Run ESLint
• npm run format: Format code with Prettier
• npm 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