sketchboard-app 1.0.3 → 1.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +144 -23
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,46 +1,167 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
```
|
|
4
|
+
╔═══════════════════════════════════════════════════════╗
|
|
5
|
+
║ ║
|
|
6
|
+
║ ✏ S K E T C H B O A R D ║
|
|
7
|
+
║ ║
|
|
8
|
+
║ Draw · Save · Share · Collaborate ║
|
|
9
|
+
║ ║
|
|
10
|
+
╚═══════════════════════════════════════════════════════╝
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
**A local-first whiteboard that lives on your machine.**
|
|
14
|
+
No account. No cloud. No setup. Just draw.
|
|
15
|
+
|
|
16
|
+
[](https://www.npmjs.com/package/sketchboard-app)
|
|
17
|
+
[](https://www.npmjs.com/package/sketchboard-app)
|
|
18
|
+
[](LICENSE)
|
|
19
|
+
[](https://nodejs.org)
|
|
20
|
+
|
|
21
|
+
</div>
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Install & Run
|
|
4
26
|
|
|
5
|
-
|
|
27
|
+
### Run instantly (no install needed)
|
|
6
28
|
|
|
7
29
|
```bash
|
|
8
30
|
npx sketchboard-app
|
|
9
31
|
```
|
|
10
32
|
|
|
11
|
-
|
|
33
|
+
Your browser opens automatically at **http://localhost:4321**.
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
### Install globally (launch from anywhere, zero wait)
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
npm install -g sketchboard-app
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Then just type:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
sketchboard
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
### Uninstall
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
npm uninstall -g sketchboard-app
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
---
|
|
12
58
|
|
|
13
59
|
## Features
|
|
14
60
|
|
|
15
|
-
- **Zero
|
|
16
|
-
- **
|
|
17
|
-
- **
|
|
18
|
-
- **
|
|
19
|
-
- **
|
|
61
|
+
- **Zero config** — one command, instant whiteboard
|
|
62
|
+
- **Saves to your machine** — drawings stored as JSON files in `~/.sketchboard/`
|
|
63
|
+
- **My Drawings sidebar** — browse, rename, load, and delete all your drawings
|
|
64
|
+
- **Ctrl+S** — save with unsaved-changes indicator in the toolbar
|
|
65
|
+
- **Share links** — generate a public read-only link for any drawing
|
|
66
|
+
- **Live collaboration** — real-time multi-user sessions over socket.io
|
|
67
|
+
- **Full export** — PNG, SVG, clipboard, or `.excalidraw` file
|
|
68
|
+
- **Light & dark theme** — auto-synced across the entire UI
|
|
69
|
+
- **Offline-capable** — works without internet once loaded
|
|
70
|
+
- **Cross-platform** — Windows, macOS, Linux
|
|
20
71
|
|
|
21
|
-
|
|
72
|
+
---
|
|
22
73
|
|
|
23
|
-
|
|
74
|
+
## Usage
|
|
24
75
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
76
|
+
```
|
|
77
|
+
╔═══════════════════════════════════════╗
|
|
78
|
+
║ SketchBoard ║
|
|
79
|
+
╠═══════════════════════════════════════╣
|
|
80
|
+
║ URL : http://localhost:4321 ║
|
|
81
|
+
║ Data : ~/.sketchboard ║
|
|
82
|
+
╚═══════════════════════════════════════╝
|
|
83
|
+
```
|
|
30
84
|
|
|
31
|
-
|
|
85
|
+
### Custom port
|
|
32
86
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
87
|
+
```bash
|
|
88
|
+
PORT=8888 npx sketchboard-app
|
|
89
|
+
# or with global install:
|
|
90
|
+
PORT=8888 sketchboard
|
|
91
|
+
```
|
|
37
92
|
|
|
38
|
-
|
|
93
|
+
### Custom data directory
|
|
39
94
|
|
|
40
95
|
```bash
|
|
41
|
-
|
|
96
|
+
SKETCHBOARD_DATA=/path/to/my/drawings npx sketchboard-app
|
|
42
97
|
```
|
|
43
98
|
|
|
99
|
+
### Environment variables
|
|
100
|
+
|
|
101
|
+
| Variable | Default | Description |
|
|
102
|
+
|---|---|---|
|
|
103
|
+
| `PORT` | `4321` | Port the server listens on |
|
|
104
|
+
| `SKETCHBOARD_DATA` | `~/.sketchboard` | Where drawings are stored |
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## Where your data lives
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
~/.sketchboard/
|
|
112
|
+
drawings/
|
|
113
|
+
<uuid>.json ← one file per drawing (permanent)
|
|
114
|
+
library.json ← your saved shape library
|
|
115
|
+
collab/ ← live collaboration room scenes
|
|
116
|
+
collab-files/ ← collaboration image files
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
| OS | Path |
|
|
120
|
+
|---|---|
|
|
121
|
+
| Windows | `C:\Users\<you>\.sketchboard\` |
|
|
122
|
+
| macOS | `/Users/<you>/.sketchboard/` |
|
|
123
|
+
| Linux | `/home/<you>/.sketchboard/` |
|
|
124
|
+
|
|
125
|
+
Plain JSON files — easy to back up, move, or sync with any tool.
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## Keyboard shortcuts
|
|
130
|
+
|
|
131
|
+
| Shortcut | Action |
|
|
132
|
+
|---|---|
|
|
133
|
+
| `Ctrl+S` / `Cmd+S` | Save current drawing |
|
|
134
|
+
| `Ctrl+Z` | Undo |
|
|
135
|
+
| `Ctrl+Shift+Z` | Redo |
|
|
136
|
+
| `V` | Selection tool |
|
|
137
|
+
| `R` | Rectangle |
|
|
138
|
+
| `E` | Ellipse |
|
|
139
|
+
| `A` | Arrow |
|
|
140
|
+
| `T` | Text |
|
|
141
|
+
| `P` | Pencil / freehand |
|
|
142
|
+
| `Delete` | Delete selected |
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
## Troubleshooting
|
|
147
|
+
|
|
148
|
+
| Problem | Fix |
|
|
149
|
+
|---|---|
|
|
150
|
+
| Port 4321 already in use | `PORT=5678 npx sketchboard-app` |
|
|
151
|
+
| Browser does not open | Manually visit `http://localhost:4321` |
|
|
152
|
+
| Old version cached by npx | `npx --yes sketchboard-app@latest` |
|
|
153
|
+
| `EACCES` error on Linux/Mac | `sudo npm install -g sketchboard-app` |
|
|
154
|
+
| Drawings not saving | Check `~/.sketchboard/drawings/` is writable |
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## Credits
|
|
159
|
+
|
|
160
|
+
Built on top of **[Excalidraw](https://github.com/excalidraw/excalidraw)** — the excellent open-source hand-drawn whiteboard (MIT licensed).
|
|
161
|
+
SketchBoard adds local persistence, drawing management, and the npm package layer.
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
44
165
|
## License
|
|
45
166
|
|
|
46
167
|
MIT
|