# lyravoid/gitlynk architecture

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

- Interactive diagram: https://gitdiagram.com/lyravoid/gitlynk
- Repository: https://github.com/lyravoid/gitlynk

## Overview

GitLynk is a static, browser-only generator for links to GitHub repository tools. A user enters a repository URL; the app validates and normalizes it locally, combines it with a local tool registry, then presents generated links in categorized cards for opening or copying. The command palette offers complementary navigation and actions, while theme and motion preferences shape the interface. README documents no backend, database, authentication, or GitHub API. Edges reflect shown App orchestration and component imports; unsampled feature details are kept at directory scope where needed.

Main entry points: [`src/App.tsx`](https://github.com/lyravoid/gitlynk/blob/main/src/App.tsx) (App orchestration), [`src/hooks/useTheme.ts`](https://github.com/lyravoid/gitlynk/blob/main/src/hooks/useTheme.ts) (Theme state), [`src/components/RepositoryPreview.tsx`](https://github.com/lyravoid/gitlynk/blob/main/src/components/RepositoryPreview.tsx) (Repository preview), [`src/components/ToolGrid.tsx`](https://github.com/lyravoid/gitlynk/blob/main/src/components/ToolGrid.tsx) (Tool browser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Repository link workflow"]
  node_app["App orchestration<br/>[App.tsx]"]
  node_repo_input["Repository input"]
  node_parser["URL parser<br/>[parser.ts]"]
  node_registry["Tool registry<br/>[tools.ts]"]
  node_generator["Link generator<br/>[generator.ts]"]
  node_preview["Repository preview"]
  node_utils["Browser utilities<br/>[utils.ts]"]
end

subgraph group_interface["Browsing interface"]
  node_tool_grid["Tool browser<br/>[ToolGrid.tsx]"]
  node_category_tabs["Category tabs<br/>[CategoryTabs.tsx]"]
  node_tool_card["Tool card<br/>[ToolCard.tsx]"]
  node_command_palette["Command palette<br/>[CommandPalette.tsx]"]
  node_hero["Hero section<br/>[Hero.tsx]"]
  node_header["Header<br/>[Header.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_preferences["Presentation preferences"]
  node_theme["Theme state<br/>[useTheme.ts]"]
  node_media_query["Media query hook<br/>[useMediaQuery.ts]"]
  node_reduced_motion["Motion preference"]
  node_visual_effects["Visual effects"]
  node_motion_components["Motion components"]
end

node_user(("User"))
node_github(("GitHub"))
node_tool_services(("Linked tool services"))

node_user -->|"enters URL"| node_repo_input
node_app -->|"renders"| node_repo_input
node_app -->|"validates input"| node_parser
node_app -->|"generates links"| node_generator
node_app -->|"provides tools"| node_registry
node_app -->|"supplies repository"| node_hero
node_hero -->|"renders"| node_repo_input
node_hero -->|"renders"| node_preview
node_app -->|"supplies generated links"| node_tool_grid
node_tool_grid -->|"renders"| node_category_tabs
node_tool_grid -->|"renders"| node_tool_card
node_tool_card -->|"links to"| node_tool_services
node_user -->|"invokes actions"| node_command_palette
node_app -->|"renders"| node_command_palette
node_app -->|"renders"| node_header
node_app -->|"renders"| node_footer
node_header -->|"changes theme"| node_theme
node_command_palette -->|"changes theme"| node_theme
node_app -->|"reads preference"| node_theme
node_theme -.->|"checks system theme"| node_media_query
node_reduced_motion -->|"checks preference"| node_media_query
node_app -->|"reads preference"| node_reduced_motion
node_app -->|"renders effects"| node_visual_effects
node_preview -->|"uses surfaces"| node_motion_components
node_app -->|"copies text"| node_utils
node_preview -->|"opens repository"| node_github
node_tool_services -->|"includes GitHub links"| node_github

click node_app "https://github.com/lyravoid/gitlynk/blob/main/src/App.tsx"
click node_repo_input "https://github.com/lyravoid/gitlynk/blob/main/src/components/RepositoryInput.tsx"
click node_parser "https://github.com/lyravoid/gitlynk/blob/main/src/lib/parser.ts"
click node_registry "https://github.com/lyravoid/gitlynk/blob/main/src/data/tools.ts"
click node_generator "https://github.com/lyravoid/gitlynk/blob/main/src/lib/generator.ts"
click node_preview "https://github.com/lyravoid/gitlynk/blob/main/src/components/RepositoryPreview.tsx"
click node_tool_grid "https://github.com/lyravoid/gitlynk/blob/main/src/components/ToolGrid.tsx"
click node_category_tabs "https://github.com/lyravoid/gitlynk/blob/main/src/components/CategoryTabs.tsx"
click node_tool_card "https://github.com/lyravoid/gitlynk/blob/main/src/components/ToolCard.tsx"
click node_command_palette "https://github.com/lyravoid/gitlynk/blob/main/src/components/CommandPalette.tsx"
click node_hero "https://github.com/lyravoid/gitlynk/blob/main/src/components/Hero.tsx"
click node_header "https://github.com/lyravoid/gitlynk/blob/main/src/components/Header.tsx"
click node_footer "https://github.com/lyravoid/gitlynk/blob/main/src/components/Footer.tsx"
click node_theme "https://github.com/lyravoid/gitlynk/blob/main/src/hooks/useTheme.ts"
click node_media_query "https://github.com/lyravoid/gitlynk/blob/main/src/hooks/useMediaQuery.ts"
click node_reduced_motion "https://github.com/lyravoid/gitlynk/blob/main/src/hooks/useReducedMotion.ts"
click node_visual_effects "https://github.com/lyravoid/gitlynk/tree/main/src/components/effects"
click node_motion_components "https://github.com/lyravoid/gitlynk/tree/main/src/components/motion"
click node_utils "https://github.com/lyravoid/gitlynk/blob/main/src/lib/utils.ts"

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_app,node_repo_input,node_parser,node_registry,node_generator,node_preview,node_utils,node_user toneBlue
class node_tool_grid,node_category_tabs,node_tool_card,node_command_palette,node_hero,node_header,node_footer toneAmber
class node_theme,node_media_query,node_reduced_motion,node_visual_effects,node_motion_components toneMint
class node_github,node_tool_services toneIndigo
```

## Components

### Repository link workflow

- [App orchestration](https://github.com/lyravoid/gitlynk/blob/main/src/App.tsx): `src/App.tsx`
- [Repository input](https://github.com/lyravoid/gitlynk/blob/main/src/components/RepositoryInput.tsx): `src/components/RepositoryInput.tsx`
- [URL parser](https://github.com/lyravoid/gitlynk/blob/main/src/lib/parser.ts): `src/lib/parser.ts`
- [Tool registry](https://github.com/lyravoid/gitlynk/blob/main/src/data/tools.ts): `src/data/tools.ts`
- [Link generator](https://github.com/lyravoid/gitlynk/blob/main/src/lib/generator.ts): `src/lib/generator.ts`
- [Repository preview](https://github.com/lyravoid/gitlynk/blob/main/src/components/RepositoryPreview.tsx): `src/components/RepositoryPreview.tsx`
- [Browser utilities](https://github.com/lyravoid/gitlynk/blob/main/src/lib/utils.ts): `src/lib/utils.ts`

### Browsing interface

- [Tool browser](https://github.com/lyravoid/gitlynk/blob/main/src/components/ToolGrid.tsx): `src/components/ToolGrid.tsx`
- [Category tabs](https://github.com/lyravoid/gitlynk/blob/main/src/components/CategoryTabs.tsx): `src/components/CategoryTabs.tsx`
- [Tool card](https://github.com/lyravoid/gitlynk/blob/main/src/components/ToolCard.tsx): `src/components/ToolCard.tsx`
- [Command palette](https://github.com/lyravoid/gitlynk/blob/main/src/components/CommandPalette.tsx): `src/components/CommandPalette.tsx`
- [Hero section](https://github.com/lyravoid/gitlynk/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [Header](https://github.com/lyravoid/gitlynk/blob/main/src/components/Header.tsx): `src/components/Header.tsx`
- [Footer](https://github.com/lyravoid/gitlynk/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`

### Presentation preferences

- [Theme state](https://github.com/lyravoid/gitlynk/blob/main/src/hooks/useTheme.ts): `src/hooks/useTheme.ts`
- [Media query hook](https://github.com/lyravoid/gitlynk/blob/main/src/hooks/useMediaQuery.ts): `src/hooks/useMediaQuery.ts`
- [Motion preference](https://github.com/lyravoid/gitlynk/blob/main/src/hooks/useReducedMotion.ts): `src/hooks/useReducedMotion.ts`
- [Visual effects](https://github.com/lyravoid/gitlynk/tree/main/src/components/effects): `src/components/effects`
- [Motion components](https://github.com/lyravoid/gitlynk/tree/main/src/components/motion): `src/components/motion`

### Other components

- **User**
- **GitHub**
- **Linked tool services**

## Connections

- User → Repository input: enters URL (evidence: `src/components/RepositoryInput.tsx`)
- App orchestration → Repository input: renders (evidence: `src/App.tsx`)
- App orchestration → URL parser: validates input (evidence: `src/App.tsx`)
- App orchestration → Link generator: generates links (evidence: `src/App.tsx`)
- App orchestration → Tool registry: provides tools (evidence: `src/App.tsx`)
- App orchestration → Hero section: supplies repository (evidence: `src/App.tsx`)
- Hero section → Repository input: renders (evidence: `src/components/Hero.tsx`)
- Hero section → Repository preview: renders (evidence: `src/components/Hero.tsx`)
- App orchestration → Tool browser: supplies generated links (evidence: `src/App.tsx`)
- Tool browser → Category tabs: renders (evidence: `src/components/ToolGrid.tsx`)
- Tool browser → Tool card: renders (evidence: `src/components/ToolGrid.tsx`)
- Tool card → Linked tool services: links to
- User → Command palette: invokes actions
- App orchestration → Command palette: renders (evidence: `src/App.tsx`)
- App orchestration → Header: renders (evidence: `src/App.tsx`)
- App orchestration → Footer: renders (evidence: `src/App.tsx`)
- Header → Theme state: changes theme (evidence: `src/App.tsx`)
- Command palette → Theme state: changes theme (evidence: `src/App.tsx`)
- App orchestration → Theme state: reads preference (evidence: `src/App.tsx`)
- Theme state → Media query hook: checks system theme
- Motion preference → Media query hook: checks preference (evidence: `src/hooks/useReducedMotion.ts`)
- App orchestration → Motion preference: reads preference (evidence: `src/App.tsx`)
- App orchestration → Visual effects: renders effects (evidence: `src/App.tsx`)
- Repository preview → Motion components: uses surfaces (evidence: `src/components/RepositoryPreview.tsx`)
- App orchestration → Browser utilities: copies text (evidence: `src/App.tsx`)
- Repository preview → GitHub: opens repository (evidence: `src/components/RepositoryPreview.tsx`)
- Linked tool services → GitHub: includes GitHub links
