# `frontend/docs/`

Architecture and audit documentation for the TorbatYar SuperApp frontend.

## Documents

| File | Description |
|------|-------------|
| [frontend-architecture.md](./frontend-architecture.md) | **Canonical architecture reference** (Phase 1+) |
| [beauty-migration-report.md](./beauty-migration-report.md) | Beauty module migration (completed) |
| [frontend-migration-plan.md](./frontend-migration-plan.md) | Phased migration roadmap |
| [frontend-architecture-audit.md](./frontend-architecture-audit.md) | Pre-migration enterprise audit |
| [module-boundaries.md](./module-boundaries.md) | Import rules and module ownership |
| [shared-components-report.md](./shared-components-report.md) | Design system inventory |
| [dependency-report.md](./dependency-report.md) | npm and API client analysis |
| [import-report.md](./import-report.md) | Import pattern analysis |
| [refactor-risk-analysis.md](./refactor-risk-analysis.md) | Refactor risk matrix |

## Directory scaffolds

Shared and module architecture READMEs live alongside code:

- [../modules/README.md](../modules/README.md)
- [../shared/README.md](../shared/README.md)
