Whim - The Secret Sharing App

Whim is a simple and secure app for sharing secret messages anonymously. The messages are end-to-end encrypted and are vanished after being read. No account required.

Running it locally

Option 1: With Docker (No Bun installation required)

If you prefer not to install Bun on your machine, you can run the entire development environment using Docker:

Prerequisites

• Docker and Docker Compose

Installation

Clone the repository:

git clone https://github.com/max-programming/whim.git
cd whim

Set up environment variables

cp .env.sample .env

Edit .env with your preferred values for development.

Run with Docker

docker-compose -f docker-compose.dev.yml up

The app will be available at http://localhost:3000. Your code changes will be automatically reflected thanks to volume mounting.

To stop the development server:

docker-compose -f docker-compose.dev.yml down

Option 2: Local Development with Bun

Prerequisites

• Bun (for package management and running the app)

Or Node with NPM, Yarn or PNPM is also fine

Installation

Clone the repository and install dependencies:

git clone https://github.com/max-programming/whim.git
cd whim
bun install

Fill in the .env file

cp .env.sample .env

Run the migrations

bun run db:migrate

Running the App

Start the development server:

bun run dev

The app will be available at http://localhost:3000 (or your configured port).

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the MIT License.