mirror of
https://github.com/DCsunset/taskwarrior-webui.git
synced 2025-08-18 21:43:06 +02:00
docs: add README
This commit is contained in:
parent
1e431728e2
commit
8bec9b809c
1 changed files with 78 additions and 0 deletions
78
README.md
Normal file
78
README.md
Normal file
|
@ -0,0 +1,78 @@
|
|||
# Taskwarrior-webui
|
||||
|
||||
Responsive Web UI for Taskwarrior based on Vue.js and Koa.js.
|
||||
|
||||
## Features
|
||||
|
||||
* Responsive layouts
|
||||
* Material Design UI
|
||||
* PWA support
|
||||
* Easy to deploy (using Docker)
|
||||
* Support multiple types of tasks
|
||||
|
||||
|
||||
## Deployment
|
||||
|
||||
### Using docker (recommended)
|
||||
|
||||
First pull the docker image:
|
||||
|
||||
```
|
||||
docker pull dcsunset/taskwarrior-webui
|
||||
```
|
||||
|
||||
Then run it with the command:
|
||||
|
||||
```
|
||||
docker run -d -p 8080:80 -v $HOME/.taskrc:/.taskrc -v $HOME/.task:/.task dcsunset/taskwarrior-webui
|
||||
```
|
||||
|
||||
### Manually deploy
|
||||
|
||||
First build the frontend:
|
||||
|
||||
```
|
||||
cd frontend
|
||||
npm install
|
||||
npm run build
|
||||
npm run export
|
||||
```
|
||||
|
||||
Then build and start the backend:
|
||||
|
||||
```
|
||||
cd backend
|
||||
npm install
|
||||
npm run build
|
||||
npm start
|
||||
```
|
||||
|
||||
Then install nginx or other web servers
|
||||
to server frontend and proxy requests to backend
|
||||
(you can refer to `nginx/nginx.conf`).
|
||||
|
||||
|
||||
## Development
|
||||
|
||||
First start the server at backend:
|
||||
|
||||
```
|
||||
cd backend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
Then start the dev server at frontend:
|
||||
|
||||
```
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
Then the frontend will listen at port 8080.
|
||||
|
||||
|
||||
## License
|
||||
|
||||
GPL-3.0 License
|
Loading…
Add table
Add a link
Reference in a new issue