An open API service indexing awesome lists of open source software.

https://github.com/sendoud/hackfolio

People can organise hackathons and manage it , the participants can showcase their projects
https://github.com/sendoud/hackfolio

jwt-authentication redux vite

Last synced: 12 months ago
JSON representation

People can organise hackathons and manage it , the participants can showcase their projects

Awesome Lists containing this project

README

          

# Hackfolio 🚀

Hackfolio is a comprehensive platform for organizing, participating in, and managing hackathons. It provides a seamless experience for hackathon organizers, participants, judges, and sponsors, all in one place.

## Features ✨

### For Organizers
- Create and manage hackathon events
- Customize hackathon registration forms
- Monitor participant registrations and submissions
- Manage judges and scoring criteria
- Track sponsor partnerships
- Real-time dashboard with event statistics
- Admin controls for event management

### For Participants
- Browse and register for hackathons
- Form or join teams
- Submit project details and presentations
- Real-time chat with team members
- Track submission status
- Display portfolio of hackathon projects

### For Judges
- Review submitted projects
- Score based on custom criteria
- Dashboard for managing evaluations
- Track judging progress

### For Sponsors
- Sponsor profile management
- View sponsored hackathon details
- Track sponsored events

## Tech Stack 💻

### Frontend
- React.js
- Redux (state management)
- Tailwind CSS
- Vite (build tool)

### Backend
- Node.js
- Express.js
- MongoDB (database)
- JWT (authentication)

## Installation 🛠️

### Prerequisites
- Node.js (v14 or higher)
- MongoDB
- npm or yarn

### Backend Setup
```bash
cd backend
npm install
npm start
```

### Frontend Setup
```bash
cd frontend
npm install
npm run dev
```

## Project Structure 📁

- `backend/`: Server-side code
- `controller/`: Business logic
- `middleware/`: Custom middleware (auth, validation)
- `models/`: Database schemas

- `frontend/`: Client-side code
- `src/components/`: Reusable UI components
- `src/pages/`: Main application pages
- `src/store/`: Redux store configuration
- `src/styles/`: CSS styles

## Contributing 🤝

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## License 📝

This project is licensed under the MIT License - see the LICENSE file for details.

## Support 📧

For support, please create an issue in the repository.