Overview • Highlights • Architecture • Tech Stack • Quick Start • Roadmap

---

🌌 Overview

Sentio transforms passive sessions into interactive, intelligent experiences.

Run live polls, quizzes, and Q&A in real time while AI handles the heavy lifting:

• generating questions,
• analyzing engagement patterns,
• summarizing sessions,
• and producing actionable reports.

Designed for educators, trainers, speakers, and event hosts.

---

✨ Core Highlights

🎯 Real-Time Engagement Live polls & quizzes Instant Q&A updates Audience count tracking Live visualization updates	🧠 AI Intelligence AI-generated questions AI session summaries Topic & keyword extraction Engagement recommendations
📊 Analytics Engine Participation rate Accuracy trends Response-time insights Engagement score	📄 Smart Reporting Auto-generated reports AI-driven insights Chart-rich summaries Export to PDF/CSV

---

🧩 Problem vs Solution

⚠️ Traditional Tools	✅ Sentio
Manual question creation	AI-generated polls/quizzes/questions
Basic analytics only	Deep engagement analytics
No in-session intelligence	Real-time AI recommendations
Generic post-session reports	Insightful, actionable AI reports

---

🏗️ Architecture

flowchart TD
    A[👥 Users] --> B[🌐 Next.js Frontend]
    B --> C[🔌 REST API + Socket.IO]
    C --> D[⚙️ Express Backend]
    D --> E[(🍃 MongoDB Atlas)]
    D --> F[(☁️ Azure Blob Storage)]
    D --> G[🧠 AI Service Layer]
    G --> H[⚡ Groq API]

Loading

---

🛠️ Tech Stack

Layer	Stack
Frontend	Next.js • React • TypeScript • Tailwind CSS • shadcn/ui • Framer Motion
Backend	Node.js • Express.js • Socket.IO
Database	MongoDB Atlas
Cloud Storage	Azure Blob Storage
AI	Groq API + Provider-abstracted AI Service Layer
DevOps	GitHub Actions • Vercel • Render

---

🔐 Security & Auth

• JWT Access + Refresh Tokens
• HTTP-only Cookies
• bcrypt Password Hashing
• Role-Based Access (Admin / Presenter / Participant)
• Helmet, CORS, Rate Limiting, Input Validation, Audit Logs

---

📈 Analytics You Can Actually Use

Sentio computes meaningful learning/engagement metrics:

• Participation Rate
• Response Accuracy
• Average Response Time
• Engagement Score
• Attendance Insights
• Poll/Quiz Distribution Trends

---

⚡ Quick Start

# Clone
git clone https://github.com/SonetShaji6/Sentio.git
cd Sentio

# Install dependencies
npm install

# Setup env
cp .env.example .env

# Run
npm run dev

---

🔧 Example Environment Variables

NODE_ENV=development
PORT=5000
CLIENT_URL=http://localhost:3000

MONGODB_URI=your_mongodb_uri

JWT_ACCESS_SECRET=your_access_secret
JWT_REFRESH_SECRET=your_refresh_secret

GROQ_API_KEY=your_groq_api_key

AZURE_STORAGE_CONNECTION_STRING=your_azure_connection_string
AZURE_STORAGE_CONTAINER=sentio-assets

---

🚀 CI/CD & Deployment

• Version Control: GitHub
• Automation: GitHub Actions (lint/test/build/deploy)
• Frontend: Vercel
• Backend: Render
• Monitoring: /health, build logs, uptime checks, Atlas metrics

---

🔮 Roadmap

• 📱 React Native mobile app
• 🌍 Multi-language experience
• 🎓 LMS integrations
• 🎥 Zoom / Teams / Meet integration
• 🗣️ Voice-based interaction
• 🏢 Enterprise SSO + billing
• 🧩 Multi-provider / self-hosted LLM support

---

🤝 Contributing

PRs are welcome!
If you’d like to improve Sentio, open an issue and submit a pull request.

---

---

💜 Built to make every session more interactive, data-driven, and unforgettable.