🎉 EventStack

Simplify event planning and coordination with EventStack

🧐 What is EventStack?

EventStack is a modern and collaborative platform designed to make event planning and coordination effortless. Whether you're organizing team meetings, social hangouts, or community events, EventStack helps you find the perfect time that works for everyone — democratically and transparently.

⭐ Star this Repository

If you find this project useful, please consider giving it a ⭐ on GitHub!

🔭 Show your support

If you like this project, consider starring it!

You can also see the amazing contributors:

🚀 Features

🔐 Simple Authentication

Secure sign-in using your GitHub account.
No password management required.

📝 Easy Event Creation

Create events in seconds:

Enter a title and description.
Add location details.
Propose multiple time slots.

🗳️ Democratic Time Selection

Participants vote on preferred slots.
Real-time voting updates.
Finalize the most popular option.

🔄 Real-Time Updates

Live data sync using websockets.
Seamless planning experience.

💬 Event Discussion

Built-in comment thread per event.
Collaborate, clarify, and coordinate.

📱 Responsive UI

Accessible on desktop, tablet, and mobile.
Plan events from anywhere.

🐳 Docker Support

Easy to build and deploy via Docker.

🔧 How It Works

Create an Event → Add details and time slots.
Share with Participants → Share the generated event link.
Collect Votes → Attendees vote on suitable times.
Finalize the Event → Choose the best slot.
Discuss Details → Use the built-in comment section.

💡 Use Cases

🧑‍💼 Team Meetings
🍕 Social Gatherings
📚 Study Groups
🛠️ Community Workshops
👨‍👩‍👧 Family Reunions

🧪 Tech Stack

Frontend: HTML, CSS, JavaScript
Backend: Python (Tornado)
Database: SQLite

📁 File Structure :-

eventstack/

├── .vercel/                # Vercel deployment config
├── handlers/               # Tornado request handlers
│   └── __pycache__/        # Compiled Python cache files
├── models/                 # Database and application models
├── static/                 # Static assets
│   ├── css/                # Stylesheets
│   ├── images/             # Icons and images
│   └── js/                 # JavaScript files
├── templates/              # HTML templates (Jinja2)
├── use/                    # Utility modules
│   ├── shareable_links/    # Modules for generating sharable links
│   └── tests/              # Test cases and test utilities
├── .gitignore              # Specifies files/folders to ignore in Git
├── Dockerfile              # Docker image configuration
├── docker-compose.yml      # Multi-container Docker configuration
├── main.py                 # Main application entry point
├── requirements.txt        # Python dependencies list
├── README.md               # Project overview and documentation
├── LICENSE.md              # Project license (MIT License)
├── CONTRIBUTING.md         # Guidelines for contributing to the project
└── CODE_OF_CONDUCT.md      # Code of conduct for contributors and community

🐳 Running with Docker

Build the Docker image:
```
docker compose build
```
Start the application:
```
docker compose up
```
Access the app: Open your browser and go to http://localhost:5050
Stop the application: Press Ctrl+C in the terminal, then run:
```
docker compose down
```

Make sure you have Docker Desktop installed.

👥 Contributors

Thanks to all the amazing people who have contributed to this project:

🛠️ Contributing

We welcome contributions to make EventStack even better.
Please read our Contributing Guidelines before submitting a pull request.

💬 Code of Conduct

Before participating in our community, please review our Code of Conduct.

📄 License

This project is licensed under the MIT License.

Made with ❤️ for better event planning

Dippp10/eventstack