docs: readme with features & usage
This commit is contained in:
parent
b455c3dfee
commit
75483db66a
31
README.md
Normal file
31
README.md
Normal file
@ -0,0 +1,31 @@
|
|||||||
|
<div align="center" style="text:align:center">
|
||||||
|
<img src="docs/media/logo.png" width="60%">
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
Available:
|
||||||
|
|
||||||
|
- Markdown support (Github flavored)
|
||||||
|
- Note version history
|
||||||
|
- Automatic note expiration via `@exp:` title prefixes
|
||||||
|
- Keyboard navigation support
|
||||||
|
- User account administration
|
||||||
|
|
||||||
|
Waiting to be implemented:
|
||||||
|
|
||||||
|
- (Bulk) import/export (Markdown, PDF)
|
||||||
|
- Webhooks
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
The Dockerized app can be run in fullstack (`docker-compose-full.yml`) and backend (`docker-compose-back.yml`) modes. In backend mode only the Golang server (and the Postgres database) are containerized and the frontend can be run separately for quicker development (`npm run dev`). The default fullstack setup defaults to exposing port 3000.
|
||||||
|
|
||||||
|
The `./scripts/run_dev.sh -h` output can be used as reference of running each of the available modes (or purging data from previous test runs with `-p` or `-q`):
|
||||||
|
|
||||||
|
```
|
||||||
|
[?] usage: ./scripts/run_dev.sh [-h|-f|-p]
|
||||||
|
-f run both frontend and backend (default: false)
|
||||||
|
-p purge any existing database artifacts (default: false)
|
||||||
|
-q only purge old data without building/spawning any new containers (default: false)
|
||||||
|
```
|
BIN
docs/media/logo.png
Normal file
BIN
docs/media/logo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 19 KiB |
Loading…
x
Reference in New Issue
Block a user