docs: CHANGE feature overview + ADD feature information to /system/info page #22

This commit is contained in:
Caffeine Fueled 2026-05-25 18:51:29 +02:00
parent c1f3d6b4db
commit 37326b9535
Signed by: cf7
GPG key ID: CA295D643074C68C
2 changed files with 36 additions and 19 deletions

View file

@ -1,6 +1,6 @@
# Aukpad
Simple **live collaboration notepad** with websockets and FastAPI.
Simple **temporary live collaboration notepad** with websockets and FastAPI — pads expire automatically after a configurable retention period.
[Issue tracker](https://git.uphillsecurity.com/cf7/aukpad/issues) | `Libera Chat #aukpad`
@ -16,23 +16,34 @@ The goal is to keep it simple! For feature-rich solutions please check out [hedg
## Features
**Use cases:**
- shared notepad on multiple machines
- shared notepad across multiple machines
- collaboration on the same notepage with multiple people (notes, config, etc)
- config changes in aukpad > `curl -o app.conf https://aukpad.com/{pad_id}/raw` > change config in aukpad > repeat `curl` command
- piping configs: `curl -o app.conf https://aukpad.com/{pad_id}/raw` → edit in aukpad → repeat
**Available**:
- live collab notepad
- line numbers
- custom path `{pad_id}` for more privacy (164 chars, `[a-zA-Z0-9_-]`)
- optional caching with valkey/redis
- pad creation with HTTP post requests with curl (see *Usage*)
- `{pad_id}/raw` HTTP endpoint
- optional password protection (HTTP endpoint accessible with GET /{pad_id}/raw?pw=mysecurepasswordhunter2)
**Editor:**
- real-time WebSocket collaboration with cursor preservation across remote edits
- per-pad password protection (PBKDF2-SHA256), with a built-in password generator in the UI
- line numbers; Tab inserts 4 spaces
- dark / light mode (auto-detects system preference, manual toggle)
- copy-to-clipboard and "new pad" buttons, live peer count in the header
**Ideas**:
**Endpoints:**
- custom pad path `{pad_id}` (164 chars, `[a-zA-Z0-9_-]`); auto-generated IDs are 8-char `[a-z0-9]`
- `POST /` — create a pad from request body (curl-friendly, see *Usage*)
- `GET /{pad_id}/raw` — raw text (auth via `?pw=…` for protected pads)
- `GET /system/info` — instance configuration page
- WebSocket `/ws/{pad_id}` — live collaboration
**Deployment:**
- optional Valkey/Redis cache for cross-restart persistence
- configurable text-size, connection, room, and retention limits
- per-IP rate limiting (pad creation + failed password attempts), reverse-proxy aware
- distroless, non-root, read-only-rootfs container image
**Ideas:**
[Check out the open feature requests](https://git.uphillsecurity.com/cf7/aukpad/issues?q=&type=all&sort=&state=open&labels=12&milestone=0&project=0&assignee=0&poster=0&archived=false)
**Not planned**:
**Not planned:**
- accounts / RBAC
---
@ -130,12 +141,6 @@ For security concerns or reports, please contact via `hello a t uphillsecurity d
---
## Notes
- [Github Mirror available](https://github.com/CaffeineFueled1/aukpad)
---
## License
**Apache License**