docs: CHANGE feature overview + ADD feature information to /system/info page #22
This commit is contained in:
parent
c1f3d6b4db
commit
37326b9535
2 changed files with 36 additions and 19 deletions
43
README.md
43
README.md
|
|
@ -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 (1–64 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}` (1–64 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**
|
||||
|
|
|
|||
12
app.py
12
app.py
|
|
@ -590,6 +590,18 @@ def get_system_info():
|
|||
<div class="info-section">
|
||||
<h2>Instance</h2>
|
||||
<p>{DESCRIPTION}</p>
|
||||
<p>Simple <strong>temporary live collaboration notepad</strong> with websockets and FastAPI — pads expire automatically after a configurable retention period.</p>
|
||||
</div>
|
||||
|
||||
<div class="info-section">
|
||||
<h2>Features</h2>
|
||||
<ul>
|
||||
<li>real-time WebSocket collaboration with cursor preservation across remote edits</li>
|
||||
<li>per-pad password protection (PBKDF2-SHA256), with a built-in password generator in the UI</li>
|
||||
<li>line numbers; Tab inserts 4 spaces</li>
|
||||
<li>dark / light mode (auto-detects system preference, manual toggle)</li>
|
||||
<li>copy-to-clipboard and "new pad" buttons, live peer count in the header</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div class="info-section">
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue