Skip to content

Commit d166182

Browse files
authored
feat: add documentation with vitepress (#50)
1 parent cfd53b0 commit d166182

27 files changed

Lines changed: 1483 additions & 64 deletions

.dockerignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,4 @@ node_modules
22
dist
33
.git
44
*.md
5+
docs

.github/workflows/docs.yml

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
name: Docs
2+
3+
on:
4+
push:
5+
branches: [master]
6+
paths:
7+
- 'docs/**'
8+
- '.github/workflows/docs.yml'
9+
workflow_dispatch:
10+
11+
permissions:
12+
contents: read
13+
pages: write
14+
id-token: write
15+
16+
concurrency:
17+
group: pages
18+
cancel-in-progress: false
19+
20+
jobs:
21+
build:
22+
runs-on: ubuntu-latest
23+
steps:
24+
- uses: actions/checkout@v4
25+
26+
- uses: oven-sh/setup-bun@v2
27+
28+
- run: bun install --frozen-lockfile
29+
30+
- run: bun run docs:build
31+
32+
- uses: actions/configure-pages@v4
33+
34+
- uses: actions/upload-pages-artifact@v3
35+
with:
36+
path: docs/.vitepress/dist
37+
38+
deploy:
39+
environment:
40+
name: github-pages
41+
url: ${{ steps.deployment.outputs.page_url }}
42+
needs: build
43+
runs-on: ubuntu-latest
44+
steps:
45+
- uses: actions/deploy-pages@v4
46+
id: deployment

.gitignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,3 +20,7 @@ pnpm-lock.yaml
2020

2121
# tests
2222
coverage/
23+
24+
# docs
25+
docs/.vitepress/dist
26+
docs/.vitepress/cache

README.md

Lines changed: 8 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@ Built with [React](https://react.dev/), [Hono](https://hono.dev/), and [Bun](htt
99
[![GitHub License](https://img.shields.io/github/license/Maciejonos/qbitwebui?style=for-the-badge&labelColor=101418&color=abedd5)](https://github.com/Maciejonos/qbitwebui/blob/master/LICENSE)
1010
[![GitHub release](https://img.shields.io/github/v/release/Maciejonos/qbitwebui?style=for-the-badge&labelColor=101418&color=b9c8da)](https://github.com/Maciejonos/qbitwebui/releases)
1111
[![Docker Build](https://img.shields.io/github/actions/workflow/status/Maciejonos/qbitwebui/docker.yml?style=for-the-badge&labelColor=101418&color=4EB329&label=build)](https://github.com/Maciejonos/qbitwebui/actions)
12+
13+
**[Documentation](https://maciejonos.github.io/qbitwebui/)** · **[Docker Examples](https://maciejonos.github.io/qbitwebui/guide/docker)** · **[All Features](https://maciejonos.github.io/qbitwebui/guide/features)**
14+
1215
</div>
1316

1417
<div align="center">
@@ -28,7 +31,7 @@ Built with [React](https://react.dev/), [Hono](https://hono.dev/), and [Bun](htt
2831
</details>
2932

3033
<details>
31-
<summary><h3>Mobile UI (PWA)</h3></summary>
34+
<summary><h3>Mobile UI</h3></summary>
3235
<div align="center">
3336
<table>
3437
<tr>
@@ -43,22 +46,22 @@ Built with [React](https://react.dev/), [Hono](https://hono.dev/), and [Bun](htt
4346

4447
- **Multi-instance** - Manage multiple qBittorrent instances from one dashboard
4548
- **Cross seed** - Automatic cross seed directly in qbitwebui. (experimental)
46-
- **Instance speed management** - Easily control global/alternative speed limits per instance
4749
- **Instance statistics** - Overview of all instances with status, speeds, torrent counts
48-
- **User accounts** - Register/login with secure session management
4950
- **Prowlarr integration** - Search indexers and send torrents directly to qBittorrent
5051
- **Real-time monitoring** - Auto-refresh torrent status, speeds, progress
5152
- **Customizable columns** - Show/hide columns, drag and drop reorder
5253
- **Torrent management** - Add via magnet/file, set priorities, manage trackers/peers
53-
- **Organization** - Filter by status, category, tag, or tracker
54+
- **Organization** - Filter by status, category, tag, or tracker, custom views
5455
- **Bulk actions** - Multi-select with context menu, keyboard navigation
5556
- **Themes** - Multiple color themes included
56-
- **Encrypted storage** - qBittorrent credentials stored with AES-256-GCM
5757
- **File browser** - Browse and download files from your downloads directory
5858
- **RSS management** - Define rules, add RSS feeds, manage folders
59+
- **Network agent** - Speedtest, IP check, DNS diagnostics from qBittorrent's network - check how to set up [Network Agent](https://maciejonos.github.io/qbitwebui/guide/network-agent)
5960

6061
## Docker
6162

63+
See [Docker section](https://maciejonos.github.io/qbitwebui/guide/docker) for all setup options.
64+
6265
```yaml
6366
services:
6467
qbitwebui:
@@ -85,12 +88,6 @@ services:
8588
restart: unless-stopped
8689
```
8790
88-
Or build locally:
89-
90-
```bash
91-
docker compose up -d
92-
```
93-
9491
## Development
9592
9693
```bash
@@ -100,19 +97,6 @@ bun install
10097
bun run dev
10198
```
10299

103-
## Environment Variables
104-
105-
| Variable | Required | Default | Description |
106-
|----------|----------|---------|-------------|
107-
| `ENCRYPTION_KEY` | Yes | - | Min 32 chars, used to encrypt stored credentials |
108-
| `PORT` | No | `3000` | Server port |
109-
| `DATABASE_PATH` | No | `./data/qbitwebui.db` | SQLite database location |
110-
| `SALT_PATH` | No | `./data/.salt` | Encryption salt file location |
111-
| `ALLOW_SELF_SIGNED_CERTS` | No | `false` | Set to `true` to allow HTTPS connections to qBittorrent instances with self-signed certificates |
112-
| `DISABLE_AUTH` | No | `false` | Set to `true` to disable login/registration (guest mode) |
113-
| `DISABLE_REGISTRATION` | No | `false` | Set to `true` to disable new registrations. Creates default `admin` account on first run (password shown in logs) |
114-
| `DOWNLOADS_PATH` | No | - | Path to downloads directory to enable file browser |
115-
116100
## Tech Stack
117101

118102
React 19, TypeScript, Tailwind CSS v4, Vite, TanStack Query, Hono, SQLite, Bun

0 commit comments

Comments
 (0)