https://github.com/aboutsource/trektor-up
Trektor as Trello Power-Up
https://github.com/aboutsource/trektor-up
Last synced: 19 days ago
JSON representation
Trektor as Trello Power-Up
- Host: GitHub
- URL: https://github.com/aboutsource/trektor-up
- Owner: aboutsource
- License: other
- Created: 2025-01-10T10:38:46.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-22T05:35:28.000Z (about 1 month ago)
- Last Synced: 2026-05-22T14:22:15.284Z (about 1 month ago)
- Language: JavaScript
- Size: 216 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TrektorUp
A Trello Power-Up to integrate Trello cards into Toggl time tracking.
## Usage
### Configure Toggl API key
To make use of TrektorUp, you first have to configure your personal Toggl API
key. To do so, click on Trello Board Menu (Three dots in the upper right
corner) -> Power-Ups -> Enabled -> Settings (Trektor) -> Edit Power-Up
settings.
### Create tracking task and start tracking
Open a card. The card must have exactly one label starting with `#`, containing
the corresponding Toggl project. The Toggl project have to exist. Look for the
Power-Ups button section on the right side of the card. Click on "Trek now".
Shortly after clicking, there will be a new card label named "Trekking", that
shows the current tracking task. The Toggl task will be created if it does not
exist.
### Re-start existing tracking task
you can also click on the Trekking label within the top section of the Trello
card to start tracking. If there is no Trekking label, you first have to create
the tracking task as shown bevore.
## GDPR
* Trektor-Up needs to access a Toggl API key. The API key is used to interact
with the Toggl API. The API key is stored in the end users browser storage
only. All Toggl API access is initiated and handled by the end users browser.
The API key is not transfered to Trello itself or any other third party
service.
* Trektor-Up generates Toggl tracking tasks on behalf of the Toggl user linked
to the Toggl API key mentioned above. The Toggl tracking tasks are based on
information attached to Trello cards. To create Toggl tracking tasks, these
data are transfered from Trello to Toggl:
* Trello card ids
* Trello card labels
* Trello card headlines.
* The Trello users are responsible to keep Trello card headlines and Trello
card labels free of personal data. Otherwise, Trektor-Up is going to create
Toggl tracking tasks that may contain these personal data.
* In addition to the data mentioned above, Trektor-Up does not access or
process any personal data.
## Hacking
TrektorUp uses Vite/Rollup for development.
git clone git@github.com:aboutsource/Trektor-Up.git
cd Trektor-Up
npm install
### Build the Power-Ip
npm run build
If build successfully, there is a dist folder containing the Power-Up
### Release a new version
* Update version string in `package.json`
* Push to github
* Tag the repo with new version
* Push tag
* Github-Actions should run the Deploy job
### Hosting and Deployment
TrektorUp is hosted at https://trello.aboutsource.net right now. The deployment
process is managed by Github-Actions. See also
https://developer.atlassian.com/cloud/trello/guides/power-ups/building-a-power-up-part-one/#getting-started
for hosting requirements.
WARNING: The hosting domain has to be manually whitelisted by the Toggl support
team. Otherwise, there are no corresponding CORS headers when accessing the
Toggl API. See also
https://github.com/toggl/toggl_api_docs/blob/master/chapters/cors.md