Nexara is a modern, AI-powered project management platform designed for development teams. Built with cutting-edge technologies and focused on developer experience.

• No-code automation using n8n (just drag and drop rules!)
• AI features like ticket summarization and sprint planning with GPT‑4
• Live dashboards and visual tools like Gantt charts
• Deep integrations with GitHub/GitLab, Slack, CI/CD tools, and more

It’s built as a full web application — not just a browser extension — meaning teams log into Zenjira just like any other SaaS platform to get started.

• 🔑 Secure Registration: Complete user registration with real-time validation
• 📧 Email Verification: Beautiful HTML emails with 6-digit OTP codes
• 🛡️ JWT Authentication: Secure token-based auth with refresh token support
• 👤 Flexible Login: Support for both email and username authentication
• 🔒 Protected Routes: Secure dashboard and user-specific content
• 🔄 Real-time Validation: Instant feedback for usernames, emails, and passwords

• 🎨 Beautiful Templates: Professional HTML email designs
• ⏱️ Smart OTP: 6-digit codes with 10-minute expiration
• 🔄 Resend Feature: Rate-limited OTP resending with countdown
• 🎯 Development Mode: Ethereal Email integration for testing
• 📬 Welcome Emails: Automated welcome messages after verification

• ⚡ Real-time Feedback: Instant username/email availability checking
• 🎯 Form Validation: Comprehensive client and server-side validation
• 🌟 Animated UI: Smooth transitions and micro-interactions
• 📱 Responsive Design: Works perfectly on all device sizes
• 🎭 Dark Theme: Modern dark interface with gradient accents

• 🔧 Type Safety: Full TypeScript implementation
• 🗄️ Database ORM: Prisma for type-safe database queries
• 📝 API Documentation: Well-documented REST endpoints
• 🧪 Error Handling: Comprehensive error management
• 🔍 Logging: Detailed logging for debugging and monitoring

gantt
    title Nexara Development Timeline
    dateFormat  MM-DD
    section Phase 1
    Authentication System   :done, p1, 08-01, 09-30
    section Phase 2
    Project Management      :active, p2, 10-01, 10-31
    section Phase 3
    AI Integration          :p3, 11-01, 11-30
    section Phase 4
    Production Launch       :p4, 12-01, 12-31

• User Authentication System - JWT tokens with refresh token support
• Email Verification - Beautiful OTP emails with 6-digit codes and HTML templates
• User Registration - Real-time validation for usernames, emails, and passwords
• Secure Login/Logout - Support for both email and username authentication
• User Dashboard - Protected routes and user profile management
• Database Schema - PostgreSQL with Prisma ORM for type-safe queries
• API Infrastructure - Express.js with comprehensive validation and error handling

• Project Creation - Create and manage multiple projects per user
• Issue Management - Create, edit, assign, and track issues with status workflows
• Project Boards - Kanban boards and basic sprint functionality
• Team Management - Invite users to projects with role-based permissions
• Project Settings - Configure project preferences and visibility

• AI Integration - GPT-4 integration for intelligent summaries and planning assistance
• Automation Engine - Workflow builder for custom automations
• External Integrations - GitHub/GitLab pull request insights and code-to-issue linking
• Real-time Collaboration - WebSocket integration for live updates
• Advanced Analytics - Sprint retrospectives and team performance metrics

• Quality Assurance - Comprehensive testing suite (Jest, Cypress)
• Performance Optimization - Load testing and optimization
• Monitoring & Observability - Prometheus, Sentry, logging
• Documentation & Launch - API docs, user guides, beta release

• Node.js 18+ and npm (or yarn)
• PostgreSQL 14+ database server
• Git for version control
• Gmail account (for email verification) or SMTP server

# Clone the repository
git clone https://github.com/Axelvyn/Nexara.git
cd Nexara

# Install frontend dependencies
cd frontend
npm install

# Install backend dependencies
cd ../backend
npm install

# Create PostgreSQL database
psql -U postgres
CREATE DATABASE nexara_db;
\q

# Or use your preferred database management tool

# Copy environment template
cd backend
cp .env.example .env

Edit .env file with your configuration:

# Database Configuration
DATABASE_URL="postgresql://username:password@localhost:5432/nexara_db?schema=public"

# JWT Configuration (generate strong secrets)
JWT_SECRET="your-super-secret-jwt-key-here-min-32-chars"
JWT_EXPIRES_IN="7d"
JWT_REFRESH_SECRET="your-super-secret-refresh-key-here-min-32-chars"
JWT_REFRESH_EXPIRES_IN="30d"

# Server Configuration
PORT=5000
NODE_ENV="development"

# Email Configuration (Gmail)
EMAIL_USER="[email protected]"
EMAIL_PASSWORD="your-app-password"  # Gmail App Password, not regular password
EMAIL_FROM="Nexara <[email protected]>"

# Frontend URL
FRONTEND_URL="http://localhost:3000"

1. Go to Google Account Settings
2. Enable 2-Factor Authentication if not already enabled
3. Go to Security → App passwords
4. Generate an app password for "Mail"
5. Use this password in EMAIL_PASSWORD (not your regular Gmail password)

# Push database schema
cd backend
npx prisma db push

# Generate Prisma client
npx prisma generate

# Optional: Seed database with test data
npm run db:seed

# Terminal 1: Start backend (from backend directory)
cd backend
npm run dev
# Backend runs on http://localhost:5000

# Terminal 2: Start frontend (from frontend directory)
cd frontend
npm run dev
# Frontend runs on http://localhost:3000

cd frontend

# Start development server with Turbopack
npm run dev        # Runs on http://localhost:3000

# Build for production
npm run build

# Start production server
npm run start

# Run linting
npm run lint

cd backend

# Start development server with auto-reload
npm run dev        # Runs on http://localhost:5000

# Start production server
npm start

# Check API health
curl http://localhost:5000/health

# Format backend code
npm run format

# Check code formatting
npm run format:check

# Option 1: Run both frontend and backend simultaneously (recommended)
npm run dev        # Runs both servers with auto-reload

# Option 2: Run individually in separate terminals
# Terminal 1: Start backend
npm run dev:backend

# Terminal 2: Start frontend
npm run dev:frontend

# Format backend code
npm run format:backend

# Check backend formatting
npm run format:check:backend

# Or from backend directory
cd backend
npm run format
npm run format:check

• Frontend: http://localhost:3000
• Backend API: http://localhost:5000
• API Health Check: http://localhost:5000/health

1. Visit http://localhost:3000/signup
2. Fill out the registration form:
   • Real-time username availability checking
   • Real-time email availability checking
   • Password strength validation with visual feedback
3. Submit form → Check your email for verification code
4. Visit verification link or enter OTP code
5. Successful verification → Redirected to dashboard

• Development Mode: Check console for Ethereal Email preview links
• Gmail Mode: Check your Gmail inbox for beautiful verification emails
• Test OTP: 6-digit codes expire in 10 minutes
• Resend Feature: 60-second cooldown between resends

1. Visit http://localhost:3000/login
2. Login with email or username
3. Unverified users → Redirected to email verification
4. Verified users → Redirected to dashboard

Database Connection Error:

# Check PostgreSQL is running
sudo service postgresql status

# Restart PostgreSQL if needed
sudo service postgresql restart

# Verify database exists
psql -U postgres -l

Email Not Sending:

# Check Gmail App Password is correct
# Verify 2FA is enabled on Google Account
# Check .env EMAIL_* variables

# Test email configuration
node -e "console.log(process.env.EMAIL_USER)"

Prisma Client Issues:

# Regenerate Prisma client
cd backend
npx prisma generate

# Reset database if needed
npx prisma db push --force-reset

Frontend Build Errors:

# Clear Next.js cache
cd frontend
rm -rf .next
npm run build

• View Emails in Development: Check console for Ethereal Email preview URLs
• Database GUI: Use npx prisma studio to view/edit database
• API Testing: Use Postman or curl to test endpoints
• Logs: Check terminal output for detailed error messages

Please read our Code of Conduct to understand the expected behavior in this community.

Please review our Community Guidelines before contributing.

Can't see the contributors graph? View all contributors on GitHub →

This project is licensed under the MIT License - see the LICENSE file for details.