2024-06-30 21:41:41 -04:00
2024-07-27 22:59:42 -04:00

2024-07-28 18:50:14 -04:00
## What is Donetick
An open-source, user-friendly app for managing tasks and chores, featuring customizable options to help you and others stay organized
2024-06-30 21:41:41 -04:00
2024-07-28 18:50:14 -04:00
## Features Highlights
2024-06-30 21:41:41 -04:00
- Task and Chore Management: Easily create, edit, and manage tasks and chores for yourself or your group.
2024-07-28 18:50:14 -04:00
- Build with sharing in mind: you give people access to you group and you can assign each other tasks. only those assigned to task or chore can see it
- Assignee Assignment: Assign tasks to specific individuals with ability rotate them automatically using customizable strategies like randomly, least completed,etc..
- Recurring Tasks: Schedule tasks to repeat daily, weekly, monthly, or yearly or something to trigger on specific day of month or day of the week. if you are not sure you can have adaptive recurring task where it does figure it out base on historical completion
2024-06-30 21:41:41 -04:00
- Progress Tracking: Track the completion status of tasks and view historical data.
2024-07-28 18:50:14 -04:00
- API Integration
2024-06-30 21:41:41 -04:00
2024-11-26 00:32:52 -05:00
## Selfhosted :
Release binary included everything needed to be up and running, as even the frontend file served
### Using Docker run :
1. pull the latest image using: `docker pull donetick/donetick`
2024-11-27 19:13:36 -05:00
2. run the container and replace `/path/to/host/data` with where you want to place attach the volumne for the sqlite db `DT_ENV=selfhosted DT_SQLITE_PATH=/donetick-data/donetick.db docker run -v /path/to/host/data:/donetick-data -p 2021:2021 donetick/donetick`
2024-11-26 00:32:52 -05:00
### Using Docker Compose:
You can use the following template
```yaml
services:
donetick:
image: donetick/donetick
container_name: donetick
restart: unless-stopped
ports:
- 2021:2021 # needed for serving backend and frontend
volumes:
2024-11-27 19:13:36 -05:00
- ./data:/donetick-data # database file stored (sqlite database)
2024-11-26 00:32:52 -05:00
- ./config:/config # configration file like selfhosted.yaml
environment:
- DT_ENV=selfhosted # this tell donetick to load ./config/selfhosted.yaml for the configuration file
2024-11-27 19:13:36 -05:00
- DT_SQLITE_PATH=/donetick-data/donetick.db
2024-11-26 00:32:52 -05:00
```
### Using binary:
2024-11-26 00:52:21 -05:00
1. Navigate to [Release]
2. Download the appropiate file for you arch/os
3. cd into the extracted folder
4. run `./donetick` and you can specify the env as `DT_ENV=selfhosted`
2024-11-26 00:32:52 -05:00
2024-07-28 18:50:14 -04:00
## Development Environment
2024-06-30 21:41:41 -04:00
1. Clone the repository:
2. Navigate to the project directory: `cd donetick`
3. Download dependency `go mod download`
4. Run locally `go run .`
2024-11-26 00:32:52 -05:00
2024-06-30 21:41:41 -04:00
## Contributing
Contributions are welcome! If you would like to contribute to Donetick, please follow these steps:
1. Fork the repository
2. Create a new branch: `git checkout -b feature/your-feature-name`
3. Make your changes and commit them: `git commit -m 'Add some feature'`
4. Push to the branch: `git push origin feature/your-feature-name`
5. Submit a pull request
## License
2024-11-26 00:32:52 -05:00
This project is licensed under the AGPLv3. See the [LICENSE ](LICENSE ) file for more details. I might consider changing it later to something else
2024-06-30 21:41:41 -04:00