# Project Structure

> Overview of the Trezor Suite monorepo structure and key directories. Use when navigating the codebase or deciding where to place new code.

- Skill: `trezor/project-structure` (Agent Skill)
- Install (CLI): `npx get-skill add trezor/project-structure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/trezor/project-structure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: trezor (https://skillmd.com/u/trezor)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/trezor/project-structure

---


# Project Structure

## Key (root) directories

- `suite` - Place where Web & Desktop only code is located.
- `suite-app` - Web & Desktop application assembly (`@suite-app/*`).
    - `app` - Shared web/desktop service composition and Connect event wiring
    - `web-app` - Web application root
    - `desktop-app`, `desktop-app-main`, `desktop-app-renderer` - Desktop application (packaging, Electron main process, renderer)
    - `storybook` - Shared web/desktop component catalogue host
- `suite-native` - Mobile features and reusable building blocks.
- `suite-native-app` - Mobile application assembly and entry point.
- `suite-common` - Shared code, that is domain specific, but can be used in all domain (Web/Desktop, Mobile).
- `packages`
    - The domain agnostic packages: libraries, tools, utils, etc.
    - `connect` - Trezor Connect (library for device communication)
    - `suite` - Shared logic for Suite applications

