React + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

• @vitejs/plugin-react uses Babel (or oxc when used in rolldown-vite) for Fast Refresh
• @vitejs/plugin-react-swc uses SWC for Fast Refresh

React Compiler

The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see this documentation.

Expanding the ESLint configuration

If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the TS template for information on how to integrate TypeScript and typescript-eslint in your project.

Getting Started

1. Clone the Repository

git clone https://github.com/your-username/numerano-feedback.git
cd numerano-feedback

2. Environment Setup

Copy the example environment file in the server directory and update it with your credentials:

cp server/.env.example server/.env

Open server/.env and replace your_mongodb_atlas_connection_string with your actual MongoDB URI.

3. Running with Docker (Recommended)

Run the following command to build and start the application:

docker-compose up --build

• Frontend: http://localhost:5173
• Backend: http://localhost:8000

🧠 BrainBuff Feature

This project now includes BrainBuff, a weekly math/logic challenge generator powered by Google's Gemini API.

• Accessible at: /brainbuff
• Features: 5-minute timer, hints, and dynamic question generation.

Gemini API Setup

This feature requires a valid Google Gemini API key.

1. Get a key from Google AI Studio.
2. Add it to server/.env:

   GEMINI_API_KEY=your_actual_api_key_here

   Note: The system uses gemini-2.5-flash for generation.

4. Running Locally

Backend:

cd server
npm install
npm run dev

Frontend:

# In a new terminal
npm install
npm run dev

API Endpoints

• POST /api/feedback: Submit feedback.
• GET /api/health: Health check.

Project Structure

.
├── server/                 # Backend (Node.js/Express)
│   ├── config/             # Database configuration
│   ├── controllers/        # Route controllers
│   ├── models/             # Mongoose models
│   ├── routes/             # API routes
│   └── index.js            # Entry point
├── src/                    # Frontend (React/Vite)
├── docker-compose.yml      # Docker orchestration
└── Dockerfile              # Frontend Dockerfile