when2meet.app

An app that helps you and your team find meeting times.

What is this?

Every time I try to schedule a meeting with my team, it usually turns into several rounds of “Can you do XX o’clock?” followed by “No, I'm dating my girlfriend at that time.” and then we have to keep searching for another time. This wastes a lot of time, so I built this app to help people quickly find a time when everyone is available.

Running locally

Prerequisites

• Node.js 18+
• pnpm
• PostgreSQL database

Installation

1. Clone the repository:

git clone https://github.com/Nat1anWasTaken/when2meet.git
cd when2meet

2. Install dependencies:

pnpm install

3. Set up environment variables:

cp .env.example .env

4. Configure your environment variables in .env:

BETTER_AUTH_SECRET=
BETTER_AUTH_URL=http://localhost:5173

GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=

DATABASE_URL="postgres://user:password@host:port/db-name"

5. Run database migrations:

pnpm db:push

6. Start the development server:

pnpm dev

Visit http://localhost:5173 to see the application running.

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes and ensure tests pass
4. Run linting: pnpm lint
5. Submit a pull request

Credit

This project is heavily inspired by when2meet.com. So if

License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.

---

Built with ❤️.