Skip to content

Commit 4291511

Browse files
bricefclaude
andcommitted
Document subpath hosting limitation, capture as TODO
The server requires its own domain — subpath hosting (e.g. /taskflow) would need a TASKFLOW_BASE_PATH config threaded through route registration, OpenAPI generation, and dashboard links. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 376bc6b commit 4291511

2 files changed

Lines changed: 8 additions & 0 deletions

File tree

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -222,6 +222,10 @@ just clean # remove build artifacts
222222

223223
Set `TASKFLOW_DEV_MODE=true` to disable all rate limiting (useful for testing and development). See [TESTING.md](TESTING.md) for the full manual QA checklist.
224224

225+
### Deployment note
226+
227+
The server must be hosted at the root of a domain (e.g. `https://taskflow.example.com`). Hosting at a subpath (e.g. `/taskflow`) is not currently supported — the dashboard, OpenAPI spec, and SSE endpoints generate absolute paths without a configurable prefix.
228+
225229
### Testing with the simulator
226230

227231
The activity simulator generates realistic board activity for testing SSE live updates:

TODO.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,10 @@ See also [TUI improvements plan](docs/plans/active/2026-03-31-tui-improvements.m
2828
- [ ] Due date visual indicator in TUI kanban (e.g. red highlight for past-due tasks)
2929
- [ ] Backup/restore: `taskflow admin backup` command (SQLite makes this easy but no tooling exists)
3030

31+
## Deployment
32+
33+
- [ ] Base path prefix support (`TASKFLOW_BASE_PATH`) — currently the server must be hosted at the root of a domain; hosting at a subpath (e.g. `/taskflow`) requires code changes to route registration, OpenAPI generation, and dashboard links
34+
3135
## Admin
3236

3337
- [ ] Webhook management from TUI (admin users currently need CLI or API)

0 commit comments

Comments
 (0)