https://github.com/iamseth/omoikane

https://github.com/iamseth/omoikane

Last synced: 6 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/iamseth/omoikane
• Owner: iamseth
• Created: 2026-04-05T00:50:21.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2026-04-05T02:22:29.000Z (4 months ago)
• Last Synced: 2026-04-05T02:26:46.090Z (4 months ago)
• Language: TypeScript
• Size: 338 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
[![Coverage](https://img.shields.io/badge/coverage-96.61%25-brightgreen)](./coverage/index.html)

[![Quality](https://img.shields.io/badge/quality-checks%20passing-brightgreen)](https://github.com/iamseth/omoikane/actions/workflows/ci.yml)

[![Actions](https://img.shields.io/github/actions/workflow/status/iamseth/omoikane/ci.yml?branch=master&label=actions)](https://github.com/iamseth/omoikane/actions/workflows/ci.yml)

[![Docker Hub](https://img.shields.io/badge/docker%20hub-iamseth%2Fomoikane-2496ED?logo=docker&logoColor=white)](https://hub.docker.com/r/iamseth/omoikane)

---

# Omoikane



Omoikane is a small scheduling app for finding the best date for a group event.

## Local Development

Install dependencies and start the dev server:

```sh

npm install

npm run dev

```

Run the Svelte and TypeScript checks with:

```sh

npm run check

```

Create a production build with:

```sh

npm run build

```

## Database

The app uses SQLite through `better-sqlite3`.

- Default database path: `data/omoikane.sqlite`

- Override with: `DATABASE_PATH=/absolute/path/to/omoikane.sqlite`

The database schema is created automatically on first server access.

## Docker Compose

Build and run the production container locally with:

```sh

docker compose up --build

```

The app will be available at `http://localhost:3000` by default. If that port is already in use, run `APP_PORT=3001 docker compose up --build` and open `http://localhost:3001` instead.

Runtime configuration:

- `APP_PORT`: optional host port for Docker Compose, defaults to `3000`

- `HOST`: defaults to `0.0.0.0` in the container

- `PORT`: defaults to `3000`

- `DATABASE_PATH`: defaults to `/app/data/omoikane.sqlite` in the container

- `ORIGIN`: optional, set this when deploying behind a public hostname

The Compose setup mounts `./data` into the container so the SQLite database persists across restarts.