Interface

Specs

• A11y theme modes (color-blind, low-vision) themes/a11y-modes.kmd

  Two additional theme modes alongside Verge light/dark — `color-blind`

• AI agent state hooks (useKoderAgent / useKoderChat) patterns/ai-agent-state-hooks.kmd

  Framework-neutral state-machine contract for any AI chat / agent

• AI agent step trace ai-ui/agent-step-trace.kmd

  Vertical step list + per-step expand (tool call, args, result, duration)

• AI artifact panel ai-ui/artifact-panel.kmd

  Side panel split-screen (desktop/web) or bottom sheet (mobile) for

• AI chat message bubble ai-ui/chat-message-bubble.kmd

  Baseline message bubble for any AI chat surface in Koder Stack:

• AI chat surface primitives patterns/ai-chat-surface.kmd

  Six composable primitives for assembling an AI chat surface in any

• AI citations / source attribution ai-ui/citations.kmd

  Footnote-style inline citations + hover/long-press preview cards +

• AI code block ai-ui/code-block.kmd

  AI-generated code rendering with language detection, syntax highlight,

• AI conversation history ai-ui/conversation-history.kmd

  Sidebar of past AI conversations: date-grouped (Today / Yesterday /

• AI cost display ai-ui/cost-display.kmd

  Per-message badge + session header total + breakdown drawer for AI

• AI feature visual language patterns/ai-feature-visual-language.kmd

  Canonical visual lexicon for distinguishing AI-driven surfaces from

• AI generated content disclaimer ai-ui/ai-disclaimer.kmd

  Risk-tiered disclaimer mechanism for AI-generated content in Koder

• AI inline suggest / ghost text ai-ui/inline-suggest.kmd

  Copilot-style ghost text autocomplete in any Koder editor surface

• AI memory drawer ai-ui/memory-drawer.kmd

  Drawer to edit AI persistent memory: list/search/edit/delete items;

• AI model selector ai-ui/model-selector.kmd

  Dropdown/menu for choosing AI model mid-conversation. Capability chips

• AI multimodal input composer ai-ui/multimodal-input.kmd

  Unified composer for text + image + file + voice input. Drag-and-drop

• AI prompt template gallery ai-ui/prompt-gallery.kmd

  Grid filterable de prompt templates: categoria + tag + author + provider

• AI streaming text ai-ui/streaming-text.kmd

  Token-by-token reveal of AI-generated text with cursor, Stop button,

• AI system prompt editor ai-ui/system-prompt-editor.kmd

  Advanced power-user editor for system prompts (Claude Projects style /

• AI thinking state ai-ui/thinking-state.kmd

  Collapsible "Thinking..." block for reasoning models (Claude extended

• AI voice mode UI ai-ui/voice-mode.kmd

  Fullscreen voice conversation mode UI: waveform (input/output color-coded),

• AI welcome / first-run screen patterns/ai-welcome-screen.kmd

  First-message hero an AI chat surface renders when the user hasn't

• AI/MCP UX/UI specs ai-ui/README.kmd

  Catalog of UX/UI specs for AI and MCP (Model Context Protocol)

• Accessibility nutrition labels accessibility/nutrition-labels.kmd

  Public per-product manifest declaring which accessibility features

• Adaptive layouts (list-detail, supporting-pane, feed) app-layout/adaptive-layouts.kmd

  Three canonical responsive layouts — list-detail, supporting-pane,

• Admin data table pattern patterns/admin-data-table.kmd

  Canonical composition pattern for Koder admin tools that list typed

• Android Compose bindings catalog develop/android-compose.kmd

  Native Android Jetpack Compose surface for Koder Design — the

• Audit Frontmatter audit/frontmatter.kmd

  Convenção do bloco `audit:` em frontmatter YAML de specs e policies

• Binary, CLI and Desktop App Naming binaries-and-cli/naming.kmd

  Nomenclatura canônica para executáveis: binário k<slug>, dir

• Brand Score (naming) naming/brand-score.kmd

  Fórmula do Brand score (Type/Pron/Son/Mem), bandas de rating, checklist

• Browser and platform support matrix develop/browser-support.kmd

  Published support contract for kds.koder.dev and every koder_web_kit

• Callout card pattern patterns/callout-card.kmd

  Dismissible in-product nudge — illustration + heading + body +

• Charts (line / bar / area / pie / scatter / graph) components/charts.kmd

  Canonical chart primitives — line / bar / stacked-bar / area /

• Chat Channel Capability Matrix chat-channels/capability-matrix.kmd

  Canonical feature surface that every Koder bot chat channel

• Combobox (typeahead select) components/combobox.kmd

  Typeahead input + dropdown of filtered options with optional async

• Command Structure commands/structure.kmd

  Estrutura canônica de um comando `/k-*` em `meta/context/commands/`:

• Component Naming Forms naming/forms.kmd

  Forms of reference for every Koder Stack component: type, display name,

• Content-Security-Policy — canonical posture for Koder Flow + sibling apps security/csp.kmd

  Normative CSP posture for Koder Flow and every sibling Koder web

• Data table (admin-grade) components/data-table.kmd

  Admin-grade tabular component — sortable columns, multi-select with

• Date picker (single, range, time) components/date-picker.kmd

  Accessible date picker — typed ISO entry + calendar grid for single

• Develop — Wear OS develop/wear-os.kmd

  Wear OS 6 surface contract: EdgeButton (arc-shaped), Primary Layout

• ESIGN digital signature — Koder Signer US profile (stub) signing/esign.kmd

  US profile (`?jurisdiction=us`) of the Koder Signer service per

• Empty state pattern patterns/empty-state.kmd

  Purpose-built UI for "no data yet" surfaces — illustration + heading

• Error Reporting (all modules) errors/reporting.kmd

  Relatório de erros para todos os módulos Koder: toggle "Relatório

• Feature deprecation / end-of-life communication patterns/deprecation.kmd

  Canonical pattern for communicating a feature's deprecation — in-app

• Feature paywall + access restriction patterns/feature-paywall.kmd

  Two sibling sub-patterns: (a) **paywall** — what surfaces when a

• Guide cue (one-shot onboarding tooltip) components/guide-cue.kmd

  One-shot tooltip-style component with arrow + title + body +

• ICP-Brasil digital signature — Koder Signer contract signing/icp-brasil.kmd

  Normative contract for the Koder Signer service

• IDE integration (VSCode + Zed + JetBrains) develop/ide-integration.kmd

  Contract for in-IDE Koder Design support — spec preview on hover,

• Index filters with saved views components/index-filters.kmd

  Composite search + filter chips + saved views companion of

• Info sprinkle (inline help dot) components/info-sprinkle.kmd

  Lightweight inline help — small "i" icon next to a label that, on

• Inline definition (contextual term explainer) components/inline-definition.kmd

  Underlined term that, on hover / focus / tap, surfaces its definition

• Internationalization (i18n) Cross-Surface Contract i18n/contract.kmd

  Contrato cross-surface de internacionalização da Koder Stack: idioma

• KDS docs mobile responsiveness develop/docs-mobile-responsiveness.kmd

  Audit + ongoing contract that every page on `kds.koder.dev` is

• Koder ID OAuth Flow — TDD Test Template auth/oauth-flow-test-template.kmd

  Test template normativo pra implementações da `specs/auth/oauth-flow.kmd`

• Koder ID OAuth Flow — consumer-side contract auth/oauth-flow.kmd

  Normative contract for every Koder component that authenticates

• Koder Pair — peer-to-peer device pairing handshake pair/handshake.kmd

  Protocolo de handshake para pareamento peer-to-peer entre dispositivos do

• KoderIPC Protocol ipc/protocol.kmd

  Protocolo de comunicação entre apps Koder (cross-process, cross-app

• Login Identifier Resolution identity/login-resolution.kmd

  How Koder ID (and any SDK or library that performs client-side

• Login Identifier Resolution — TDD Test Templates identity/login-resolution-test-template.kmd

  TDD test templates for the contract in

• MCP elicitation UI ai-ui/mcp-elicitation.kmd

  UI for MCP server-initiated user input requests mid-tool-execution

• MCP integration (KDS for AI agents) develop/mcp-integration.kmd

  How AI coding agents (Claude Code, Cursor, Codex, Windsurf) connect to

• MCP permission prompt ai-ui/mcp-permission-prompt.kmd

  Consent gate UI before invoking MCP tools with side effects. Implements

• MCP sampling approval ai-ui/mcp-sampling-approval.kmd

  UI for MCP server-initiated LLM completion requests delegated to

• MCP server state ai-ui/mcp-server-state.kmd

  Connection state visibility for every MCP server attached to a Koder

• MCP tool invocation card ai-ui/mcp-tool-invocation.kmd

  Visual indicator + arguments preview + result rendering for every

• Model viewer components/model-viewer.kmd

  Interactive 3D model viewer — embed a glTF/GLB mesh that the user can

• Multi-step wizard patterns/wizard-multistep.kmd

  Linear or branching multi-step flow with per-step validation, step

• OUIA test hooks (data-ouia-* contract) testing/ouia-test-hooks.kmd

  Every KDS-spec'd component MUST emit Open UI Automation (OUIA)

• Per-platform code samples toggle develop/code-samples-toggle.kmd

  Every component page on `kds.koder.dev` ships code samples for

• Phone input (country selector + i18n format) components/phone-input.kmd

  Country-aware phone input — country selector + locale-aware mask +

• RFC frontmatter — `phases:` array rfc-frontmatter/phases.kmd

  Convention for declaring multi-phase migration plans in RFC frontmatter

• Scoped Consent Tokens identity/consent.kmd

  Koder ID issues, validates, and revokes signed, scoped consent

• Settings Patterns settings/patterns.kmd

  Convenção mestre de tela Settings em apps Koder: hierarquia canônica de

• Skeleton (loading placeholder) components/skeleton.kmd

  Skeleton placeholder primitives — block / line / circle / image —

• Snapshot manifest format (.kvg) snapshots/manifest.kmd

  Normative format for the Koder Snapshot manifest (`.kvg` — Koder Value

• Standard CLI Flags for Koder Apps binaries-and-cli/standard-flags.kmd

  Toda app Koder com binário CLI/desktop/TUI (Flutter desktop,

• Variantes — Taxonomy variants/taxonomy.kmd

  Define o termo **variante** como instância executável de um componente

• Voice — Wake-word + Talk Mode (settings + privacy) voice/wake-word.kmd

  Toggles obrigatórios em Settings (`voice.enabled`, `voice.talkMode`,

• Wire/API compatibility — Koder Flow vs upstream Forgejo wire-compat/flow-vs-forgejo.kmd

  Normative contract for the wire/API surfaces Koder Flow promises to

• Workflow Executor Protocol workflow/executor-protocol.kmd

  Contrato de como o engine do Koder Workflow (services/ai/workflow) invoca

• XR developer preview develop/xr-preview.kmd

  Forward-looking spec for Koder Design on XR surfaces (Vision Pro,

• XR — canonical composables develop/xr-composables.kmd

  Material 3 XR canonical composables: Orbiter, SpatialPanel,

• contract cache-purge/contract.kmd
• eIDAS digital signature — Koder Signer EU profile (stub) signing/eidas.kmd

  EU profile (`?jurisdiction=eu`) of the Koder Signer service per

• i18n TDD Test Template (Cross-Surface) i18n/test-template.kmd

  Template normativo de testes TDD pra validar conformidade com

• i18n leak detection i18n/leak-detection.kmd

  Detection contract for "i18n leaks" — user-facing string literals

• iOS SwiftUI bindings catalog develop/ios-swiftui.kmd

  Native iOS SwiftUI surface for Koder Design — the set of SwiftUI

• kds-public-api api/kds-public-api.kmd