# brunar/tanstack-br architecture

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

- Interactive diagram: https://gitdiagram.com/brunar/tanstack-br
- Repository: https://github.com/brunar/tanstack-br

## Overview

This TanStack Start application presents itself as a platform for discovering and sharing developer skills, with routes for skill browsing, skill details, user skills, favorites, and dashboard settings. The visible home-page workflow loads Pokémon data through a server function and renders entries as interactive likeable cards; the favorite page submits a name to a server function that currently simulates saving. The route tree and several page implementations are shown, but most routes are placeholders. No persistent database implementation is evident in the sampled source.

Main entry points: [`src/routeTree.gen.ts`](https://github.com/brunar/tanstack-br/blob/main/src/routeTree.gen.ts) (Route tree), [`src/routes/index.tsx`](https://github.com/brunar/tanstack-br/blob/main/src/routes/index.tsx) (Skill listing), [`src/server/pokemon.ts`](https://github.com/brunar/tanstack-br/blob/main/src/server/pokemon.ts) (Pokémon server functions), [`src/routes/favorite.tsx`](https://github.com/brunar/tanstack-br/blob/main/src/routes/favorite.tsx) (Favorite form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App routing"]
  node_router["Router setup<br/>[router.tsx]"]
  node_route_tree["Route tree<br/>[routeTree.gen.ts]"]
  node_root["Root document<br/>[__root.tsx]"]
  node_about["About page<br/>[about.tsx]"]
  node_contact["Contact page<br/>[contact.tsx]"]
  node_dashboard["Dashboard layout<br/>[route.tsx]"]
  node_dashboard_home["Dashboard home<br/>[index.tsx]"]
  node_dashboard_skills["Dashboard skills<br/>[skills.tsx]"]
  node_dashboard_settings["Dashboard settings<br/>[settings.tsx]"]
end

subgraph group_skills["Skill experience"]
  node_skill_home["Skill listing<br/>[index.tsx]"]
  node_skill_card["Skill card<br/>[SkillCard.tsx]"]
  node_skills_index["Skills index<br/>[index.tsx]"]
  node_skill_detail["Skill detail<br/>[$skillId.tsx]"]
  node_user_skill["User skill detail<br/>[$skillId.tsx]"]
end

subgraph group_pokemon["Pokémon demo"]
  node_pokemon_server["Pokémon server functions<br/>[pokemon.ts]"]
  node_favorites["Favorite form<br/>[favorite.tsx]"]
end

node_visitor(("Visitor"))
node_pokeapi["PokéAPI"]

node_router -->|"configures"| node_route_tree
node_route_tree -->|"registers"| node_root
node_route_tree -->|"registers"| node_about
node_route_tree -->|"registers"| node_contact
node_route_tree -->|"registers"| node_dashboard
node_route_tree -->|"registers"| node_dashboard_home
node_route_tree -->|"registers"| node_dashboard_skills
node_route_tree -->|"registers"| node_dashboard_settings
node_route_tree -->|"registers"| node_skill_home
node_route_tree -->|"registers"| node_skills_index
node_route_tree -->|"registers"| node_skill_detail
node_route_tree -->|"registers"| node_user_skill
node_route_tree -->|"registers"| node_favorites
node_visitor -->|"opens"| node_skill_home
node_skill_home -->|"loads data"| node_pokemon_server
node_pokemon_server -->|"fetches"| node_pokeapi
node_skill_home -->|"renders"| node_skill_card
node_visitor -->|"submits favorite"| node_favorites
node_favorites -->|"invokes save"| node_pokemon_server

click node_router "https://github.com/brunar/tanstack-br/blob/main/src/router.tsx"
click node_route_tree "https://github.com/brunar/tanstack-br/blob/main/src/routeTree.gen.ts"
click node_root "https://github.com/brunar/tanstack-br/blob/main/src/routes/__root.tsx"
click node_about "https://github.com/brunar/tanstack-br/blob/main/src/routes/about.tsx"
click node_contact "https://github.com/brunar/tanstack-br/blob/main/src/routes/contact.tsx"
click node_dashboard "https://github.com/brunar/tanstack-br/blob/main/src/routes/dashboard/route.tsx"
click node_dashboard_home "https://github.com/brunar/tanstack-br/blob/main/src/routes/dashboard/index.tsx"
click node_dashboard_skills "https://github.com/brunar/tanstack-br/blob/main/src/routes/dashboard/skills.tsx"
click node_dashboard_settings "https://github.com/brunar/tanstack-br/blob/main/src/routes/dashboard/settings.tsx"
click node_skill_home "https://github.com/brunar/tanstack-br/blob/main/src/routes/index.tsx"
click node_skill_card "https://github.com/brunar/tanstack-br/blob/main/src/components/SkillCard.tsx"
click node_skills_index "https://github.com/brunar/tanstack-br/blob/main/src/routes/skills/index.tsx"
click node_skill_detail "https://github.com/brunar/tanstack-br/blob/main/src/routes/skills/%24skillId.tsx"
click node_user_skill "https://github.com/brunar/tanstack-br/blob/main/src/routes/users/%24username/skills/%24skillId.tsx"
click node_pokemon_server "https://github.com/brunar/tanstack-br/blob/main/src/server/pokemon.ts"
click node_favorites "https://github.com/brunar/tanstack-br/blob/main/src/routes/favorite.tsx"

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_router,node_route_tree,node_root,node_about,node_contact,node_dashboard,node_dashboard_home,node_dashboard_skills,node_dashboard_settings toneBlue
class node_skill_home,node_skill_card,node_skills_index,node_skill_detail,node_user_skill toneAmber
class node_pokemon_server,node_favorites,node_pokeapi toneMint
class node_visitor toneIndigo
```

## Components

### App routing

- [Router setup](https://github.com/brunar/tanstack-br/blob/main/src/router.tsx): `src/router.tsx`
- [Route tree](https://github.com/brunar/tanstack-br/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Root document](https://github.com/brunar/tanstack-br/blob/main/src/routes/__root.tsx): `src/routes/__root.tsx`
- [About page](https://github.com/brunar/tanstack-br/blob/main/src/routes/about.tsx): `src/routes/about.tsx`
- [Contact page](https://github.com/brunar/tanstack-br/blob/main/src/routes/contact.tsx): `src/routes/contact.tsx`
- [Dashboard layout](https://github.com/brunar/tanstack-br/blob/main/src/routes/dashboard/route.tsx): `src/routes/dashboard/route.tsx`
- [Dashboard home](https://github.com/brunar/tanstack-br/blob/main/src/routes/dashboard/index.tsx): `src/routes/dashboard/index.tsx`
- [Dashboard skills](https://github.com/brunar/tanstack-br/blob/main/src/routes/dashboard/skills.tsx): `src/routes/dashboard/skills.tsx`
- [Dashboard settings](https://github.com/brunar/tanstack-br/blob/main/src/routes/dashboard/settings.tsx): `src/routes/dashboard/settings.tsx`

### Skill experience

- [Skill listing](https://github.com/brunar/tanstack-br/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Skill card](https://github.com/brunar/tanstack-br/blob/main/src/components/SkillCard.tsx): `src/components/SkillCard.tsx`
- [Skills index](https://github.com/brunar/tanstack-br/blob/main/src/routes/skills/index.tsx): `src/routes/skills/index.tsx`
- [Skill detail](https://github.com/brunar/tanstack-br/blob/main/src/routes/skills/%24skillId.tsx): `src/routes/skills/$skillId.tsx`
- [User skill detail](https://github.com/brunar/tanstack-br/blob/main/src/routes/users/%24username/skills/%24skillId.tsx): `src/routes/users/$username/skills/$skillId.tsx`

### Pokémon demo

- [Pokémon server functions](https://github.com/brunar/tanstack-br/blob/main/src/server/pokemon.ts): `src/server/pokemon.ts`
- [Favorite form](https://github.com/brunar/tanstack-br/blob/main/src/routes/favorite.tsx): `src/routes/favorite.tsx`

### Other components

- **Visitor**
- **PokéAPI**

## Connections

- Router setup → Route tree: configures (evidence: `src/router.tsx`)
- Route tree → Root document: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → About page: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Contact page: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Dashboard layout: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Dashboard home: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Dashboard skills: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Dashboard settings: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Skill listing: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Skills index: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Skill detail: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → User skill detail: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Favorite form: registers (evidence: `src/routeTree.gen.ts`)
- Visitor → Skill listing: opens (evidence: `src/routes/index.tsx`)
- Skill listing → Pokémon server functions: loads data (evidence: `src/routes/index.tsx`)
- Pokémon server functions → PokéAPI: fetches (evidence: `src/server/pokemon.ts`)
- Skill listing → Skill card: renders (evidence: `src/routes/index.tsx`)
- Visitor → Favorite form: submits favorite (evidence: `src/routes/favorite.tsx`)
- Favorite form → Pokémon server functions: invokes save (evidence: `src/routes/favorite.tsx`)
