# dietrichmax/colota

> colota is an Android app for self-hosted GPS tracking. It sends the device's location to a server the user runs, over HTTP(S), and it can also work fully offline without a server. The project is written mainly in TypeScript, with Kotlin for the Android native code.

Source: https://github.com/dietrichmax/colota
Indexed: commit ca1b83f on 2026-08-18 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: TypeScript
- Stars: 716 at index time
- License: AGPL-3.0
- Code health: 7.7/10, Good
- Last commit: 2026-08-17
- Contributors: 5

## Install

From the README: https://github.com/dietrichmax/colota#quick-start

Clone the colota repository.
    git clone https://github.com/dietrichmax/colota.git

Move into the colota folder.
    cd colota

After cloning the repository, install the dependencies from the repository root.
    npm ci

Build the shared package that the apps depend on.
    npm run build -w @colota/shared

Change into the Android project directory.
    cd apps/mobile/android

Build the Google Play variant of the app.
    ./gradlew assembleGmsRelease

## How it works

The mobile app lives in apps/mobile, and apps/mobile/App.tsx is its TypeScript entry point. Tracking runs as a foreground service in apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt, which handles the location work on the Android side. apps/mobile/android/app/src/main/java/com/colota/bridge/LocationServiceModule.kt connects the TypeScript app code to that native Android code. Exports are produced by apps/mobile/android/app/src/main/java/com/colota/export/ExportConverters.kt, which converts stored locations into the supported file formats. packages/shared holds code shared across the apps as @colota/shared, and it must be built before the Android app is compiled. apps/docs contains the documentation site, with its build scripts in apps/docs/scripts.

- apps/docs/scripts/generate-releases.mjs: entry point
- apps/mobile/App.tsx: entry point
- packages/shared/logo/generate-icons.mjs: entry point
- .github/FUNDING.yml: central file
- .github/ISSUE_TEMPLATE/bug_report.md: central file
Modules: apps, .github, packages, root, scripts. 377 files, 61,603 lines, 3,968 symbols.

## Code health

- Score: 7.7/10 (Good)
- Rank: #88 of 4,000+ indexed repos
- Hotspots: apps/mobile/android/app/src/test/java/com/Colota/service/LocationForegroundServiceTest.kt, apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt, apps/mobile/android/app/src/main/java/com/colota/export/ExportConverters.kt, apps/mobile/android/app/src/main/java/com/colota/bridge/LocationServiceModule.kt, apps/mobile/android/app/src/test/java/com/Colota/sync/NetworkManagerTest.kt
- Lowest file: apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt
- Dead code: 21 findings

## Maintenance

- Last commit 2026-08-17, first commit 2026-02-13, 818 commits
- 5 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/dietrichmax/colota/security

## More

- Page: https://repowise.dev/repo/dietrichmax/colota
- Ask this codebase: https://repowise.dev/repo/dietrichmax/colota/chat
- Docs: https://repowise.dev/repo/dietrichmax/colota/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/dietrichmax/colota
