https://github.com/codeforafrica/promisetracker
Promise Tracker is a tool designed to help journalists and civil society watchdogs track campaign/promises/pledges by government officials. Accessible at https://promisetracker.dev.codeforafrica.org/
https://github.com/codeforafrica/promisetracker
africa development disinfo disinformation economics elections fact-checking graphql kenya misinfo misinformation pesacheck politicians politics promise-tracker promises reactjs tracker trello
Last synced: 2 months ago
JSON representation
Promise Tracker is a tool designed to help journalists and civil society watchdogs track campaign/promises/pledges by government officials. Accessible at https://promisetracker.dev.codeforafrica.org/
- Host: GitHub
- URL: https://github.com/codeforafrica/promisetracker
- Owner: CodeForAfrica
- Created: 2019-09-10T08:46:27.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-10-14T07:10:09.000Z (7 months ago)
- Last Synced: 2025-10-14T09:02:46.431Z (7 months ago)
- Topics: africa, development, disinfo, disinformation, economics, elections, fact-checking, graphql, kenya, misinfo, misinformation, pesacheck, politicians, politics, promise-tracker, promises, reactjs, tracker, trello
- Language: TypeScript
- Homepage: https://promisetracker.dev.codeforafrica.org/
- Size: 26.7 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
**PromiseTracker**, is a tool to help journalists and civil society watchdogs more easily track campaign promises and other political / government pledges, using official evidence / data, as well as crowdsourced information, with a transparent and defensible methodology, to help inject accountability and honesty into the often cavalier way that promises are made to citizens to win their support for elections, policies, contracts ... but are then seldom honoured.
### Requirements
1. CheckDesk API Key and Team ID
2. Airtable API Key and Base ID
3. Google Gemini API Key.
4. Docker
## Running the App.
1. Install dependencies
`pnpm i`
2. Start Apache Tika
`docker compose up -d`
3. Run dev server
`pnpm dev`
4. Update settings in admin
[/admin/globals/settings]
5. When testing multitenant app, use a domain that resolves to localhost, similar to `localtest.me`, for example `ken.localtest.me:3000`
## Docker Image
- Build the production image (bundles Apache Tika 3.2.3, no database services) using Docker BuildKit secrets:
```
docker build -t promisetracker:latest \
--secret id=database_uri,env=DATABASE_URI \
--secret id=payload_secret,env=PAYLOAD_SECRET \
.
```
Provide `DATABASE_URI` and `PAYLOAD_SECRET` (build fails if they’re missing); Sentry secrets are optional. You can also point secrets at files via `--secret id=…,src=path/to/file`.
- Run the container against an external database:
`docker run -p 3000:3000 -e DATABASE_URI="" -e PAYLOAD_SECRET="" promisetracker:latest`
- The bundled Apache Tika server listens on `http://127.0.0.1:9998/`. Override `AX_APACHE_TIKA_URL`, `TIKA_PORT`, or `TIKA_ENABLED=0` if you prefer an external Tika service.