You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+32-42Lines changed: 32 additions & 42 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,6 +2,12 @@
2
2
3
3
A modern, self-hosted checklist and document management application built with Next.js 14, TypeScript, and Tailwind CSS. rwMarkable allows users to create, manage, and collaborate on checklists and rich text documents with a beautiful, responsive interface.
4
4
5
+
<palign="center">
6
+
<ahref="https://www.buymeacoffee.com/fccview">
7
+
<img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy me a coffee" width="150">
8
+
</a>
9
+
</p>
10
+
5
11
## ✨ Features
6
12
7
13
### 📋 Checklist Management
@@ -95,17 +101,39 @@ A modern, self-hosted checklist and document management application built with N
95
101
96
102
1.**Using Docker Compose (Recommended)**
97
103
104
+
- Create a `docker-compose.yml` file:
105
+
106
+
```bash
107
+
services:
108
+
app:
109
+
image: ghcr.io/fccview/rwmarkable:main
110
+
container_name: rwmarkable
111
+
user: "1001:65533"
112
+
ports:
113
+
- "1234:3000"
114
+
volumes:
115
+
- ./data:/app/data:rw # Do NOT change this volume name.
116
+
restart: unless-stopped
117
+
environment:
118
+
- NODE_ENV=production
119
+
init: true
120
+
```
121
+
122
+
- Assign the right permissions and start the container:
123
+
98
124
```bash
125
+
sudo chown -R 1001:65533 data/
99
126
docker-compose up -d
100
127
```
101
128
102
129
2.**Using Docker directly**
130
+
- Pull the repository locally
103
131
```bash
104
132
docker build -t rwmarkable .
105
-
docker run -p 3000:3000 -v checklist_data:/app/data rwmarkable
133
+
docker run -p 1234:3000 -v data:/app/data rwmarkable
106
134
```
107
135
108
-
The application will be available at `http://localhost:3000`
136
+
The application will be available at `http://localhost:1234`
109
137
110
138
## 🔧 Configuration
111
139
@@ -168,42 +196,6 @@ The application uses a simple file-based storage system:
168
196
-**Input validation** and sanitization
169
197
-**CSRF protection** through Next.js built-in security
170
198
171
-
## 🐳 Docker Deployment
172
-
173
-
The application includes optimized Docker configuration for production deployment:
174
-
175
-
### Production Docker Compose
176
-
177
-
```yaml
178
-
version: "3.8"
179
-
services:
180
-
app:
181
-
image: ghcr.io/riofriz/checklist:latest
182
-
container_name: rwMarkable
183
-
ports:
184
-
- "3000:3000"
185
-
volumes:
186
-
- checklist_data:/app/data
187
-
restart: unless-stopped
188
-
189
-
volumes:
190
-
checklist_data:
191
-
```
192
-
193
-
### Custom Docker Build
194
-
195
-
```bash
196
-
# Build the image
197
-
docker build -t rwmarkable .
198
-
199
-
# Run with persistent data
200
-
docker run -d \
201
-
--name rwmarkable \
202
-
-p 3000:3000 \
203
-
-v $(pwd)/data:/app/data \
204
-
rwmarkable
205
-
```
206
-
207
199
## 🤝 Contributing
208
200
209
201
1.**Fork the repository**
@@ -224,6 +216,8 @@ If you encounter any issues or have questions:
224
216
2.**Search existing issues** on GitHub
225
217
3.**Create a new issue** with detailed information about your problem
226
218
219
+
I don't have a lot of free time, but I'll try to keep an eye on it all.
220
+
227
221
## 🔄 Updates
228
222
229
223
To update your installation:
@@ -243,7 +237,3 @@ yarn install
243
237
yarn build
244
238
yarn start
245
239
```
246
-
247
-
---
248
-
249
-
**rwMarkable** - Simple, powerful, and beautiful checklist and document management.
0 commit comments