swsrkty / kukkee Goto Github PK

Kukkee — free and open source meeting poll tool

Kukkee is a free and open source meeting poll tool. Quickly find a time which works for everyone without the back-and-forth texts/emails!

• Create a meeting poll by choosing the time slots based on your availability.
• Copy and share the poll link with the participants to let them mark their availability.
• Find the most popular times and see who's free with "yes" votes - or who can be - with "if need be" votes, and book the meeting!

Create a poll now at Kukkee.com!

After my GSoC '20 at LiberTEM, I wanted to have a video call with my mentors. They said yes, and since the next step was to find a suitable and common time, one of them sent me a link to a meeting poll created using a proprietary online service. It had surprisingly bad UX and was covered with advertisements. I searched for good, free and open source meeting poll tools, but didn't find any. So I decided to fix that problem.

If you have suggestions for how Kukkee could be improved, please add your thoughts on a relevant discussion here or start a new discussion. If you have any questions, I'd love to hear them too! If you want to report an issue, check if the issue is already opened here otherwise open a new one.

Coming soon!

Kukkee is built with MongoDB and Next.js, so for a quick and free setup, you can use a free MongoDB Atlas cluster and Vercel's hobby plan.

You can get started with MongoDB Atlas for free here. Make sure to add all IP addresses (0.0.0.0/0) to the IP access list of your Atlas cluster since it is not possible to determine the IP addresses of Vercel deployments.

You can get started with Vercel's hobby plan for free:

1. Fork this repo to your own GitHub account
2. Go to https://vercel.com/dashboard
3. Create a new project
4. Import your forked repository
5. Set the environment variables (according to the instructions in .env.example)
6. Deploy

First, make sure you have Node.js and MongoDB installed. Then, to develop locally:

1. Fork this repo to your own GitHub account and then clone it.

   git clone https://github.com/<your-username>/Kukkee.git

2. Go to the project folder

   cd Kukkee

3. Create a new branch:

   git checkout -b MY_BRANCH_NAME

4. Install the dependencies with:

   npm i

5. Copy .env.example to .env

   cp .env.example .env

6. Set the env variables according to the instructions in the .env file

7. Start developing and watch for code changes:

   npm run dev

8. Please make sure that you can make a full production build before opening a PR. You can build the project with:

   npm run build

Thanks to FOSS United for selecting Kukkee as one of the winning projects at FOSS Hack 3.0.

Thanks to these amazing projects which help power Kukkee:

• React-big-calendar
• React
• Next.js
• Day.js
• Bootstrap
• MongoDB
• Mongoose
• Inter
• Cal Sans

Kukkee is distributed under the MIT License.