Truly – Anonymous Feedback Platform

✨ Share and receive honest, boundary-free feedback — built with security, modern design, and AI at its core.

---

---

🔒 Secure. Your privacy is protected at every step.
⚡ Fast. Built on cutting-edge frameworks for seamless performance.
🧠 Smart. AI-enhanced insights powered by Google Gemini.

---

🎯 What is Truly?

Truly is a modern, anonymous feedback platform built with Next.js 15, TypeScript, and AI-powered features.
It allows users to collect honest feedback securely and effortlessly — with a sleek glassmorphism UI and Gemini AI conversation starters.

✨ Key Highlights

• 🎨 Glass UI – Modern glassmorphism with gradients & animations
• 🔐 Authentication – Secure email/password login with verification
• 🎭 Anonymous Messaging – Send & receive feedback without revealing identity
• 🤖 AI Suggestions – Gemini AI generates engaging feedback prompts
• ⚡ Real-time Updates – Instantly fetch, delete, or toggle messages
• 📱 Responsive Design – Works beautifully on mobile, tablet, and desktop
• 🌓 Dark Mode Ready – Seamless light/dark theme switching

---

🚀 Features

🎨 Modern UI/UX Glassmorphism with blur & gradients Responsive design for all devices Smooth animations with Framer Motion Dark/light theme support 🔐 Authentication & Security NextAuth.js with credential-based login Secure password hashing with bcrypt Email verification (Resend API) Zod schema validation & CSRF protection

✉️ Anonymous Feedback Unique profile links (e.g. /u/username) Send messages without login Toggle message acceptance ON/OFF Delete or refresh messages in real-time 🤖 AI-Powered Experience Gemini AI generates conversation starters Real-time streaming of suggestions Encourage meaningful, friendly feedback

---

🛠️ Tech Stack

Core

Backend & Database

AI & Email

UI/UX

📦 Complete Dependencies

• Auth & Security: NextAuth.js, bcryptjs, Zod
• Database: MongoDB, Mongoose
• AI: Vercel AI SDK, Google Gemini
• UI/UX: TailwindCSS, Shadcn/ui, Radix UI, Lucide React, React Icons, Sonner, Framer Motion
• Forms: React Hook Form, Hookform Resolvers, Zod
• Email: Resend API, React Email
• Dev Tools: Turbopack, ESLint, PostCSS

---

🏗️ Project Structure

📦 truly/
├── 📁 src/
│   ├── 📁 app/
│   │   ├── (app)/dashboard/      # User dashboard
│   │   ├── (auth)/sign-in/       # Login & Sign Up
│   │   ├── api/                  # API routes
│   │   └── u/[username]/         # Public profiles
│   ├── 📁 components/            # Reusable components
│   ├── 📁 lib/                   # Utilities (dbConnect, etc.)
│   ├── 📁 models/                # MongoDB schemas
│   ├── 📁 schemas/               # Zod validation
│   └── 📁 types/                 # TypeScript definitions
└── 📄 README.md

---

🚀 Quick Start

Prerequisites

• Node.js v18+
• MongoDB (local or Atlas)
• Git

🔧 Installation

# Clone repository
git clone https://github.com/Aksh8t/truly.git
cd truly

# Install dependencies
npm install

⚙️ Environment Variables

Create .env.local in project root:

MONGODB_URI=your_mongodb_connection_string
NEXTAUTH_SECRET=your_secret
NEXTAUTH_URL=http://localhost:3000
RESEND_API_KEY=your_resend_api_key
GEMINI_API_KEY=your_gemini_api_key

🏃 Run the Application

npm run dev

📡 API Reference

🔐 Authentication

Method	Endpoint	Description
POST	/api/sign-up	Register user
POST	/api/verify-code	Verify email
POST	/api/auth/[...nextauth]	Auth handler

✉️ Messages

Method	Endpoint	Description
POST	/api/send-message	Send anonymous message
GET	/api/get-messages	Fetch user messages
DELETE	/api/delete-message/:id	Delete a message

🤖 AI Suggestions

Method	Endpoint	Description
POST	/api/suggest-messages	Generate AI-based prompts

---

🎯 Roadmap

• 💬 Message reactions & ratings
• 📊 Advanced analytics dashboard
• 🔍 Message filtering & search
• 🤝 Multi-AI model support
• 🎨 Custom themes & branding
• 📤 Export messages to PDF
• 🔑 Two-factor authentication

---

Made with ❤️ by Akshat Tiwari

⭐ Star this repo if you find it helpful! ⭐

```