Skip to content

TrueFeedback is a modern web platform that allows users to share anonymous feedback with individuals or organizations - without revealing their identity.

Notifications You must be signed in to change notification settings

onkkkar/truefeedback

Repository files navigation

TrueFeedback 📝

A Modern Anonymous Feedback Platform

TrueFeedback Platform Interface

Demo GitHub


TrueFeedback is a cutting-edge web application that enables organizations, teams, and individuals to collect honest, anonymous feedback through a secure and user-friendly platform. Built with modern web technologies, it provides a seamless experience for both feedback providers and receivers.

✨ Features

  • 📝 Anonymous feedback submission to users or organizations
  • 🔒 Secure email verification for feedback recipients
  • 🧑‍💻 User-friendly forms for submitting feedback
  • 🕵️ Full anonymity for the feedback provider
  • ⚡ Scalable and efficient tech stack

📁 Project Structure

truefeedback/
├── public/                # Static assets and images
├── src/
│   ├── app/              # Next.js App Router pages
│   ├── components/       # Reusable UI components
│   ├── lib/             # Utility functions and configurations
│   ├── models/          # MongoDB/Mongoose schemas
│   ├── types/           # TypeScript type definitions
│   └── emails/          # Email templates
├── middleware.ts         # NextAuth.js middleware
├── next.config.js       # Next.js configuration
└── ...config files

🛠️ Tech Stack

Frontend

  • Next.js 14 - React framework with App Router
  • React 18 - JavaScript library for building user interfaces
  • TypeScript - Type-safe JavaScript development
  • Tailwind CSS - Utility-first CSS framework
  • React Hook Form - Performant form handling
  • Lucide React - Beautiful icon library
  • next-themes - Theme management system
  • Shadcn/UI - Re-usable component library

Backend & Database

  • MongoDB - NoSQL database for scalable data storage
  • Mongoose - MongoDB object modeling for Node.js
  • NextAuth.js - Complete authentication solution
  • Resend - Modern email delivery service
  • Node.js - JavaScript runtime environment

Validation & API

  • Zod - TypeScript-first schema validation
  • Next.js API Routes - Serverless API endpoints
  • bcryptjs - Password hashing and security
  • JSON Web Tokens (JWT) - Secure token-based authentication

Development Tools

  • ESLint - Code linting and quality assurance
  • Prettier - Code formatting
  • TypeScript - Static type checking
  • Git - Version control system
  • Vercel - Deployment platform

Additional Libraries

  • React Hot Toast - Toast notifications
  • Axios - HTTP client for API requests
  • Date-fns - Date utility library
  • Clsx - Utility for constructing className strings

🚀 Getting Started

Prerequisites

  • Node.js 18+ and npm/yarn/pnpm
  • MongoDB database (local or cloud)
  • Environment variables setup

Installation

  1. Clone the repository

    git clone https://github.com/onkar-03/truefeedback.git
    cd truefeedback
  2. Install dependencies

    npm install
    # or
    yarn install
    # or
    pnpm install
  3. Environment Setup

    Create a .env.local file in the root directory:

    # Database
    MONGODB_URI=your_mongodb_connection_string
    
    # NextAuth.js
    NEXTAUTH_SECRET=your_nextauth_secret
    NEXTAUTH_URL=http://localhost:3000
    
    # Email Service (Resend)
    RESEND_API_KEY=your_resend_api_key
    
    # App Configuration
    NEXT_PUBLIC_APP_URL=http://localhost:3000
  4. Database Setup

    Ensure your MongoDB database is running and accessible with the provided connection string.

  5. Run the development server

    npm run dev
    # or
    yarn dev
    # or
    pnpm dev
  6. Open your browser

    Navigate to http://localhost:3000 to see the application.

Build for Production

npm run build
npm start

📖 Usage

For Feedback Receivers

  1. Sign Up/Sign In - Create an account or log in
  2. Verify Email - Complete email verification process
  3. Access Dashboard - View and manage received feedback
  4. Share Feedback Link - Send your unique feedback collection link
  5. Monitor Responses - Track and analyze incoming feedback

For Feedback Providers

  1. Access Feedback Link - Use the shared link from feedback receiver
  2. Submit Anonymous Feedback - Provide honest feedback without revealing identity
  3. Instant Delivery - Feedback is immediately available to the receiver

Built with ❤️ by Onkar

If you found this project helpful, please consider giving it a ⭐ on GitHub!

About

TrueFeedback is a modern web platform that allows users to share anonymous feedback with individuals or organizations - without revealing their identity.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published