https://github.com/TimerErTim/plapok
Realtime collaborative simple to use planning poker for sprint planning. Uses SpacetimeDB 2.0 and GitHub Pages for hosting.
https://github.com/TimerErTim/plapok
nextjs planning react rust scrum self-hosted spacetimedb sprint
Last synced: about 2 months ago
JSON representation
Realtime collaborative simple to use planning poker for sprint planning. Uses SpacetimeDB 2.0 and GitHub Pages for hosting.
- Host: GitHub
- URL: https://github.com/TimerErTim/plapok
- Owner: TimerErTim
- License: mit
- Created: 2026-03-03T21:30:34.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-24T23:37:33.000Z (3 months ago)
- Last Synced: 2026-04-03T19:36:08.449Z (2 months ago)
- Topics: nextjs, planning, react, rust, scrum, self-hosted, spacetimedb, sprint
- Language: TypeScript
- Homepage: http://plapok.timerertim.eu/
- Size: 545 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 🚀 Plapok
**Plapok** is a beautiful, minimal planning poker application designed for agile teams who value speed and simplicity. Built with **React**, **HeroUI v3**, and powered by **SpacetimeDB 2.0**, it offers real-time synchronization without the overhead of traditional state management.
## 🛠 Tech Stack
* **Frontend**: React (TSX) + Vite
* **UI Components**: [HeroUI v3](https://v3.heroui.com/) (formerly NextUI)
* **Styling**: Tailwind CSS
* **Backend/Database**: [SpacetimeDB 2.0](https://spacetimedb.com/) (Rust-based server modules)
* **Runtime/Env Management**: [mise](https://mise.jdx.dev/) (mise-en-place)
---
## 🏗 Setup & Mise-en-place
We use **mise** to ensure every contributor has the exact same versions of Node, Rust, and the SpacetimeDB CLI.
### 1. Install mise
If you don't have it yet:
```bash
curl https://mise.jdx.dev/install.sh | sh
```
### 2. Trust and Install Tools
Clone the repo and run:
```bash
# Setup all runtimes (Node, Rust, SpacetimeDB CLI)
mise trust
mise run prepare:web
```
---
## 🚀 Quick Start
### Backend (SpacetimeDB)
The backend logic lives in the `/server` directory and is written in Rust.
1. **Start SpacetimeDB locally**:
```bash
spacetime start
```
### Frontend
1. **Install dependencies**:
```bash
mise run prepare:web
```
### Configuration
Create two files for local deployment:
1. `spacetime.local.json`
```json
{
"server": "local",
"database": "plapok-01"
}
```
2. `mise.local.toml`
```toml
[env]
VITE_SPACETIMEDB_URI = "http://localhost:3000"
VITE_SPACETIMEDB_MODULE = "plapok-01"
```
**Run the dev environment**:
```bash
mise run dev
```
---
## 🎮 Features
* **No Accounts**: Just enter a name and a room code.
* **Real-time**: Powered by SpacetimeDB reducers; no WebSockets to manually manage.
* **Minimalist UI**: Pastel matte aesthetics with light/dark mode support.
* **Responsive**: Designed for mobile standby and desktop "second-screen" use.
---
## 📜 Contributing
1. Check out a new branch: `git checkout -b feature/cool-feature`
2. Ensure `mise` has your environment synced.
3. Submit a PR!