---
ui_doc_type: component
component_id: shell-navigation
status: 구현됨
source_evidence:
  - type: code
    path: lib/src/features/app_shell.dart
    notes: "_BrandHeader와 NavigationRail destination mapping"
  - type: docs
    path: README.md
    notes: "Current Scaffold feature 목록"
  - type: user
    path: null
    notes: "agent-ui 생성 요청"
---

# Shell Navigation

Component ID: `shell-navigation`

Status: `구현됨`

## Source Evidence

| Type | Path | Notes |
|------|------|-------|
| code | `lib/src/features/app_shell.dart` | `_BrandHeader`와 `NavigationRail` destination mapping |
| docs | `README.md` | Current Scaffold feature 목록 |
| user | 없음 | agent-ui 생성 요청 |

## Purpose

AppSok brand와 네 개의 primary destination을 항상 보이게 제공한다.

## Used By

- `app-shell`: `app-shell.nav`

## Anatomy

- AppSok icon mark
- AppSok title과 `Jenkins to USB` subtitle
- extended NavigationRail
- destination icon, selected icon, label

## Variants

- default: desktop/macOS sidebar width 196

## States

- default
- selected
- disabled: 없음

## Rules

- destination은 shell이 소유한 `_pages` 순서를 따른다.
- label은 현재 화면의 top bar title과 동일해야 한다.

## Decision History

- 2026-06-25: shell NavigationRail을 공통 component로 기록했다.