<<<<<<< HEAD

🚀 NexoraFlow – Google GenAI Exchange Hackathon 2025

A comprehensive AI-powered workflow, career, and productivity dashboard built with React, TypeScript, Node.js, Tailwind, and GenAI capabilities.
Designed as part of the Google GenAI Exchange Hackathon 2025.

---

🟦 Status & Tech Badges

---

✨ Core Features

🏠 Core Modules

• AI-Powered Dashboard – Real-time metrics & insights
• Side Hustle Discovery Hub – Personalized opportunities
• AI Resilience Coach – Career & mental wellness guidance
• Achievement Gamification – XP, rewards, progress badges
• Adaptive Learning Pathways – Personalized upskilling paths
• Community Nexus Hub – Collaboration & engagement

---

🛠 Technical Features

• ⚡ React 19 + TypeScript
• 🎨 Tailwind CSS
• 🔄 Hot Module Reloading
• 🌐 Express.js REST API
• 🔒 Production-optimized build
• 🤖 Google Gemini AI integration
• 📱 Fully responsive design

---

🚀 Quick Start Guide

📌 Prerequisites

• Node.js 18+
• npm or yarn

📥 Installation

git clone https://github.com/lavanitha/GenAI-Exchange-Hackathon-NexoraFlow-Prototype-Refined.git
cd nexoraflow-dashboard
npm install
npm run dev:full

📦 Deployment Options

🌐 Deploy on Vercel (Recommended)

npm i -g vercel
vercel --prod

🌊 Netlify

Build production files:

npm run build

🐳 Docker Deployment

docker build -t nexoraflow-dashboard .
docker run -p 3002:3002 nexoraflow-dashboard

☁️ Cloud Deployment Options

🚆 Railway.app,: Import GitHub repo → Auto-deploy backend → Add environment variables.
🟦 DigitalOcean,: Connect GitHub → Choose backend service → Auto-build & deploy.
🟩 Render.com,1.: Deploy backend service.2. Deploy frontend as static site (CDN).
🟪 Heroku,heroku container: push webheroku container: release web

🔧 Environment Configuration

🟦 Frontend .env

VITE_API_URL=https://your-api-url.com/api
VITE_APP_NAME=NexoraFlow Dashboard

🟩 Backend .env (backend/.env)

PORT=3002
NODE_ENV=production
CORS_ORIGIN=https://your-frontend-url.com
GENAI_API_KEY=your_google_gemini_api_key

📁 Project Structure

nexoraflow-dashboard/
├── dist/                 
├── src/
│   ├── components/       
│   ├── pages/            
│   ├── contexts/         
│   ├── hooks/            
│   ├── types/            
│   └── services/         
├── backend/
│   ├── routes/           
│   ├── middleware/       
│   └── server.js         
├── public/               
└── package.json

🎨 Customization

Styling

• Tailwind configuration → tailwind.config.js
• Global CSS → src/index.css
• Component styles → inside each component

Feature Expansion

• Add new pages → src/pages/
• Add new components → src/components/
• Add backend API routes → backend/routes/

📊 Available Scripts

npm run dev              # Frontend only
npm run backend:dev      # Backend only
npm run dev:full         # Frontend + backend
npm run build            # Build frontend
npm run preview          # Preview production build
npm run lint             # Lint code
npm run type-check       # TypeScript checks

🌟 Key Components & Modules

UI Components

• Interactive Cards
• Progress Bars
• Toast Notifications
• Loading Skeletons
• Animations Dashboard Features
• Real-time charts
• AI-driven suggestions
• Quick action widgets
• Activity timeline

🔗 API Endpoints Overview

Backend supports:

• Dashboard analytics
• AI recommendations
• User progression
• Community features
• Learning modules
• Optional authentication

📱 Browser Support

• Chrome 90+
• Firefox 88+
• Safari 14+
• Edge 90+
• Mobile browsers

🤝 Contributing

git checkout -b feature/my-feature

Steps:

1. Fork repository
2. Create feature branch
3. Commit changes
4. Push branch
5. Open Pull Request

📄 License

This project is licensed under the MIT License.

🆘 Support

• Check deploy.md
• Review GitHub issues
• Contact the NexoraFlow team

Built with Passion by the NexoraFlow Team - Mary Lavanitha Sunder & M.Manikandakan

---

🌐 Live Deployment

🚀 View Live App: https://nexoraflow-genai.vercel.app/

👤 Connect With Me

=======

GenAI-Exchange-Hackathon-NexoraFlow-Prototype-Refined

NexoraFlow – AI-Powered Career & Skills Advisor NexoraFlow is a futuristic platform that empowers students and young professionals with personalized, AI-driven career guidance. It combines Skill DNA Mapping, Career Twin Simulation, Side Hustle Generator, AI Resilience Coaching, and Blockchain-verified Skill Passports to transformer.

e7c3a4e36a671f98fea7800576e57546029b1fe3