PR Time Tracker is a GitHub bot that tracks core developer activity related to PRs and issues. This repository contains the user-facing part of the application. The bot's webhook handling code is located in the pr-time-tracker-webhooks repository.
If you want to contribute, please follow the Holdex Developer Guidelines.
- Troubleshooting: Cannot submit time
- Visit the PR Time Tracker App page on GitHub
- Install the app in your organization
- Invite @pr-time-tracker to your organization and grant owner permissions
- To manage repository access, go to "Settings" -> "GitHub Apps"
To connect your organization with the Time Tracker, contact the Holdex Team to add your project's information to the pr-time-tracker-webhooks repository configuration:
{
"name": "org_slug",
"nodeId": "oracle_project_id"
}
Configuration parameters:
name
: Your GitHub organization slugnodeId
: Holdex Oracle project ID (use337c06eb
for HX project column if no specific project is defined)
postinstall
: Sets up Husky for Git hookspull-env
: Pulls environment variables for developmentdev
: Starts the development server (port 3000)build
: Builds the projectpreview
: Previews the production buildformat
: Formats code using Prettier (with Svelte and Pug plugins)lint
: Lints code using ESLint (JavaScript, TypeScript, Svelte, and CommonJS)check
: Syncs SvelteKit and validates TypeScript configurationtype-check
: Performs TypeScript type checkingcheck:watch
: Watches for changes while checking TypeScript and syncing SvelteKitproxy
: Creates an ngrok tunnel with a specific domain for development
- Clone this repository
- Install dependencies:
pnpm install
- Pull environment variables:
pnpm pull-env
The application requires two environment variables for the check-run retrigger functionality:
TRIGGER_SERVER_URL
TRIGGER_SERVER_SECRET
These variables are not generated by the pull-env
script. You have two options:
-
Full Functionality Setup:
- Set up pr-time-tracker-webhooks locally
- Add to
.env
:TRIGGER_SERVER_URL=<your-local-webhook-server-url> TRIGGER_SERVER_SECRET=<your-local-webhook-secret>
-
Partial Functionality Setup:
- Comment out the code that uses these variables if you don't need the check-run retrigger feature
- Start the proxy:
pnpm proxy
(required for GitHub login) - Start the development server:
pnpm dev
- Visit the app at
https://alert-seemingly-moccasin.ngrok-free.app