# bespoyasov/frontend-clean-architecture

React + TypeScript app built using the clean architecture principles in a more functional way.

Repository: https://github.com/bespoyasov/frontend-clean-architecture
Canonical: https://ross.abutalabs.com/products/frontend-clean-architecture
Homepage: https://bespoyasov.me/blog/clean-architecture-on-frontend/
Language: TypeScript
License Family: other
Topics: clean-architecture, onion-architecture, domain, application, adapters, layered-architecture, functional
Last push: 2025-01-25T14:09:51+00:00

## Health v2 (maintenance only)
Score: 34/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 3, release rhythm 35, longevity 100
- inputs: {"age_days": 1913, "days_push": 585, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2584, forks 292 (observed 2026-08-28T04:07:02.601847+00:00)

## What it is
A React + TypeScript example application demonstrating clean architecture principles applied to frontend development in a functional style. It accompanies a detailed article and talk explaining domain, application, and adapter layers for frontend apps.

## Use cases
- learn how to apply clean architecture to a React frontend
- see an example of layered architecture with TypeScript
- understand domain, use case, and adapter separation in frontend code
- study a functional approach to clean architecture
- find a reference project for structuring a cookie store app
- learn about shared kernel and dependency rules on the frontend

## When to choose
- you want a practical, working example of clean architecture on the frontend
- you prefer functional-style code over OOP-heavy examples
- you want accompanying written and video explanations
- you use React and TypeScript and want architectural guidance

## When to avoid
- you need a production-ready boilerplate or starter template
- you want a maintained library or framework to install
- you need strict canonical clean architecture without documented compromises
- you require a project with an explicit open-source license

## Facets
- artifact type: learning-resource
- maturity: active
- function: developer-tools, documentation
- domain: web-development, frontend, tutorials, developer-tools
- platform: cross-platform
- tags: clean-architecture, react, typescript, example-app, onion-architecture, ddd, functional-programming, sample-project, web, nodejs

## Member repositories
- bespoyasov/frontend-clean-architecture (main) score 34

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:02.601847+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:22:29.051785+00:00, confidence not recorded.
  - readme: https://github.com/bespoyasov/frontend-clean-architecture (fetched 2026-08-28T04:07:02.601847+00:00, sha acb10376c672)
  - homepage: https://bespoyasov.me/blog/clean-architecture-on-frontend/ (fetched 2026-08-29T10:05:15.420127+00:00, sha b8f7e03db240)
- Data as of 2026-08-30T08:39:29.467469+00:00.