OSIPY Dashboard

Dashboard scaffold for OSIPY projects

The current version is intentionally frontend-only. Login, account creation, PocketBase, and seed scripts were removed until the dashboard needs persistence.

Tech Stack

• SvelteKit 2 and Svelte 5
• Tailwind CSS 4 and daisyUI
• Bun runtime
• Docker Compose for local development

Development

Run the app through Docker Compose with Bun:

make dev

make dev opens the dashboard at http://localhost:60010. Docker Compose maps host port 60010 to the frontend container's fixed port 37183.

You can also run it locally without Docker:

bun install
bun run dev

Direct Vite development uses http://localhost:60010. After bun run build, bun run preview uses http://localhost:60014. Both ports are strict, so Vite exits if the configured port is unavailable.

Before opening a pull request, run:

bun run check
bun run lint
bun run build

Configuration

Copy .env.example to .env if you want to use Docker Compose directly. FRONTEND_PORT controls only the host side of the 60010:37183 mapping:

cp .env.example .env

Citation

If you use OSIPY Dashboard in your work, cite it using the metadata in CITATION.cff. Release archives can be connected to Zenodo using the metadata in .zenodo.json.

Project Practices

See CONTRIBUTING.md for the contribution workflow, SECURITY.md for vulnerability reporting, GOVERNANCE.md for decision-making and handover expectations, and docs/release.md for release notes.

License

MIT License. See LICENSE.