kitty-you-can-has-cheese-burger-mwahhh

Description

The Doubts Portal is a web application designed for the orientation program. The system enabled 3000+ attendees to submit questions anonymously, allows administrators to review and moderate these submissions, and displays approved doubts in a live feed presentation format with 3D visual effects.

Features

• 🌐 Api

• 🕸️ Web

Tech Stack

• Next.js
• Three.js

Main System Architecture

#D Graphics System

Data Model and State Management

Key Dependencies

@heroicons/react: ^2.2.0
bcrypt: ^6.0.0
chroma-js: ^3.1.2
framer-motion: ^12.23.12
mongoose: ^8.17.1
next: 15.4.6
next-auth: ^4.24.11
react: 19.1.0
react-dom: 19.1.0
react-hot-toast: ^2.5.2
simplex-noise: ^4.0.3
swiper: ^11.2.10
three: ^0.179.1
tone: ^15.1.22

Run Commands

• dev: npm run dev
• build: npm run build
• start: npm run start
• lint: npm run lint

Project Structure

ccs_doubts1
├── app
│   ├── Loader3D.jsx
│   ├── admin
│   │   ├── display
│   │   │   ├── page.jsx
│   │   │   └── page.module.css
│   │   ├── page.jsx
│   │   └── page.module.css
│   ├── api
│   │   └── doubts
│   │       ├── [id]
│   │       │   └── route.js
│   │       └── route.js
│   ├── ask
│   │   ├── page.jsx
│   │   └── page.module.css
│   ├── components
│   │   ├── CCSLoader.jsx
│   │   ├── CCSLoader.module.css
│   │   ├── DoubtsSwiper.jsx
│   │   └── DoubtsSwiper.module.css
│   ├── globals.css
│   ├── layout.js
│   ├── mainframe
│   │   ├── page.module.css
│   │   └── page.tsx
│   ├── page.js
│   ├── page.module.css
│   └── three
│       └── coef.jsx
├── lib
│   └── mongodb.js
├── middleware.ts
├── models
│   ├── Doubt.js
│   └── User.js
├── package.json
├── pnpm-lock.yaml
├── public
│   ├── ccs_logo.glb
│   └── portal.jpg
└── tsconfig.json

Development Setup

Node.js/JavaScript Setup

1. Install Node.js (v18+ recommended)
2. Install dependencies: npm install or yarn install
3. Start development server: (Check scripts in package.json, e.g., npm run dev)

Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Clone your fork: git clone https://github.com/TANICE-GAWD/kitty-you-can-has-cheese-burger-mwahhh.git
3. Create a new branch: git checkout -b feature/your-feature
4. Commit your changes: git commit -am 'Add some feature'
5. Push to your branch: git push origin feature/your-feature
6. Open a pull request

Please ensure your code follows the project's style guidelines and includes tests where applicable.