# romboooo/release-radar architecture

> Architecture diagram of the GitHub repository romboooo/release-radar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/romboooo/release-radar
- Repository: https://github.com/romboooo/release-radar

## Overview

release-radar is a terminal-based GitHub release tracker with both command-line and interactive TUI workflows. The executable opens a local SQLite database and creates a tracker service, then selects the CLI when arguments are supplied or the TUI otherwise. Users can add, list, check, review history, and delete tracked repositories. Checks prefer GitHub releases, fall back to the latest stable semantic-version tag when no release exists, and persist discoveries. The excerpts show these principal calls; the GitHub client also exposes tag and repository-existence requests.

Main entry points: [`cmd/rradar/main.go`](https://github.com/romboooo/release-radar/blob/main/cmd/rradar/main.go) (Application startup), [`internal/tracker/tracker.go`](https://github.com/romboooo/release-radar/blob/main/internal/tracker/tracker.go) (Tracker service), [`internal/tui/tui.go`](https://github.com/romboooo/release-radar/blob/main/internal/tui/tui.go) (Interactive TUI), [`internal/cli/cli.go`](https://github.com/romboooo/release-radar/blob/main/internal/cli/cli.go) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_entrypoint["Application startup<br/>[main.go]"]
end

subgraph group_interfaces["User interfaces"]
  node_cli["CLI commands<br/>[cli.go]"]
  node_tui["Interactive TUI<br/>[tui.go]"]
end

subgraph group_tracking["Tracking domain"]
  node_tracker["Tracker service<br/>[tracker.go]"]
  node_github_api["GitHub API client<br/>[client.go]"]
end

subgraph group_persistence["Persistence"]
  node_sqlite_store[("SQLite store<br/>[sqlite.go]")]
end

node_terminal_user(("Terminal user"))
node_github_service{{"GitHub API"}}

node_terminal_user -->|"runs commands"| node_entrypoint
node_entrypoint -->|"opens database"| node_sqlite_store
node_entrypoint -->|"creates service"| node_tracker
node_entrypoint -->|"dispatches arguments"| node_cli
node_entrypoint -->|"runs interactive mode"| node_tui
node_terminal_user -->|"uses TUI"| node_tui
node_cli -->|"invokes commands"| node_tracker
node_tui -->|"invokes actions"| node_tracker
node_tracker -->|"reads and writes"| node_sqlite_store
node_tracker -->|"checks repositories"| node_github_api
node_github_api -->|"requests repository data"| node_github_service

click node_entrypoint "https://github.com/romboooo/release-radar/blob/main/cmd/rradar/main.go"
click node_cli "https://github.com/romboooo/release-radar/blob/main/internal/cli/cli.go"
click node_tui "https://github.com/romboooo/release-radar/blob/main/internal/tui/tui.go"
click node_tracker "https://github.com/romboooo/release-radar/blob/main/internal/tracker/tracker.go"
click node_github_api "https://github.com/romboooo/release-radar/blob/main/internal/github/client.go"
click node_sqlite_store "https://github.com/romboooo/release-radar/blob/main/internal/store/sqlite.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entrypoint,node_terminal_user toneBlue
class node_cli,node_tui toneAmber
class node_tracker,node_github_api,node_github_service toneMint
class node_sqlite_store toneRose
```

## Components

### Application entry

- [Application startup](https://github.com/romboooo/release-radar/blob/main/cmd/rradar/main.go): `cmd/rradar/main.go`

### User interfaces

- [CLI commands](https://github.com/romboooo/release-radar/blob/main/internal/cli/cli.go): `internal/cli/cli.go`
- [Interactive TUI](https://github.com/romboooo/release-radar/blob/main/internal/tui/tui.go): `internal/tui/tui.go`

### Tracking domain

- [Tracker service](https://github.com/romboooo/release-radar/blob/main/internal/tracker/tracker.go): `internal/tracker/tracker.go`
- [GitHub API client](https://github.com/romboooo/release-radar/blob/main/internal/github/client.go): `internal/github/client.go`

### Persistence

- [SQLite store](https://github.com/romboooo/release-radar/blob/main/internal/store/sqlite.go): `internal/store/sqlite.go`

### Other components

- **Terminal user**
- **GitHub API**

## Connections

- Terminal user → Application startup: runs commands (evidence: `README.md`)
- Application startup → SQLite store: opens database (evidence: `cmd/rradar/main.go`)
- Application startup → Tracker service: creates service (evidence: `cmd/rradar/main.go`)
- Application startup → CLI commands: dispatches arguments (evidence: `cmd/rradar/main.go`)
- Application startup → Interactive TUI: runs interactive mode (evidence: `cmd/rradar/main.go`)
- Terminal user → Interactive TUI: uses TUI (evidence: `README.md`)
- CLI commands → Tracker service: invokes commands (evidence: `internal/cli/cli.go`)
- Interactive TUI → Tracker service: invokes actions (evidence: `internal/tui/tui.go`)
- Tracker service → SQLite store: reads and writes (evidence: `internal/tracker/tracker.go`)
- Tracker service → GitHub API client: checks repositories (evidence: `internal/tracker/tracker.go`)
- GitHub API client → GitHub API: requests repository data (evidence: `internal/github/client.go`)
