{"id":15646891,"url":"https://github.com/garronej/clean-architecture","last_synced_at":"2026-04-09T05:32:03.598Z","repository":{"id":48518672,"uuid":"439673426","full_name":"garronej/clean-architecture","owner":"garronej","description":"📐 A clean architecture framework","archived":false,"fork":false,"pushed_at":"2025-12-19T19:30:56.000Z","size":982,"stargazers_count":50,"open_issues_count":2,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-02T06:12:31.317Z","etag":null,"topics":["backend","clean-architecture","framwork","react","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/garronej.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-12-18T17:19:25.000Z","updated_at":"2025-12-19T19:29:30.000Z","dependencies_parsed_at":"2024-08-21T18:05:16.692Z","dependency_job_id":"9f0f24ef-71f6-47d5-b737-733af6db34f0","html_url":"https://github.com/garronej/clean-architecture","commit_stats":{"total_commits":310,"total_committers":6,"mean_commits":"51.666666666666664","dds":0.3516129032258064,"last_synced_commit":"b9066eae32624acb6880243bab164864081ca0a8"},"previous_names":["garronej/redux-clean-architecture"],"tags_count":113,"template":false,"template_full_name":"garronej/ts-ci","purl":"pkg:github/garronej/clean-architecture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garronej%2Fclean-architecture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garronej%2Fclean-architecture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garronej%2Fclean-architecture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garronej%2Fclean-architecture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/garronej","download_url":"https://codeload.github.com/garronej/clean-architecture/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garronej%2Fclean-architecture/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31587798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"online","status_checked_at":"2026-04-09T02:00:06.848Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","clean-architecture","framwork","react","typescript"],"created_at":"2024-10-03T12:15:38.031Z","updated_at":"2026-04-09T05:32:03.591Z","avatar_url":"https://github.com/garronej.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/6702424/151054088-b21c1cd6-912a-4dcf-b54d-af74e8632620.png\"\u003e  \n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ci\u003e📐 TypeScript Clean Architecture Framework  📐\u003c/i\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/garronej/clean-architecture/actions\"\u003e\n      \u003cimg src=\"https://github.com/garronej/clean-architecture/actions/workflows/ci.yaml/badge.svg\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://bundlephobia.com/package/clean-architecture\"\u003e\n      \u003cimg src=\"https://img.shields.io/bundlephobia/minzip/clean-architecture\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/garronej/clean-architecture/blob/main/LICENSE\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/l/clean-architecture\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\nThis is a Framework for building web application. It helps you decouple your UI component\nand the core logic of your App.  \nIt can be used both on the frontend and the backend and integrate well with any UI framework\nbut it's primary use case is for building SPAs (Vite Projects) with React.\n\n-   [Benefits](#benefits)\n-   [Install / Import](#install--import)\n-   [Examples setups](#examples-setups)\n    -   [Example project](#example-project)\n    -   [Canonical setup](#canonical-setup)\n    -   [Enterprise grade app](#enterprise-grade-app)\n-   [Starting the demo app](#starting-the-demo-app)\n\n# Benefits\n\n-   Clean architecture without [the object-orientedness](https://www.youtube.com/watch?v=QM1iUe6IofM).\n-   No need to explicitly call `dispatch()` on the UI side.  \n    As a matter of fact, Redux being used\n    under the hood is an implementation detail that can as well be ignored by the dev working on the UI.\n-   Strict isolation between the Core and the UI. Port your web app to React Native or switch to another\n    UI framework without having to re-write a single line of the core logic.\n-   It's not specifically a React framework, it's not even specifically a frontend framework, it can and is be used on the backend.\n-   Names things once, it propagate through all the codebase via [TypeScript's template literal types](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html). No more hard to maintain stuttering.  \n    Name things once then let intellisense guide you.\n-   The core can tell the UI to do thing imperatively. Like \"Play a sound now\" which is something that\n    is impossible to do cleanly with just states. (`isSoundShouldBePlayedNow: boolean` ?)\n\n# Install / Import\n\n```bash\n$ yarn add clean-architecture evt\n```\n\n# Examples setups\n\n## Example project\n\n\u003cimg width=\"438\" alt=\"image\" src=\"https://github.com/garronej/snake-clean-architecture/assets/6702424/2cd5e5ee-0d5c-443b-95a7-b3c288da1233\"\u003e\n\nThis is a very basic snake game implemented with Vite/TypeScript/React/Clean-Architecture.\n\n[👉 `garronej/snake-clean-architecture`👈 ](https://github.com/garronej/snake-clean-architecture)\n\n## Canonical setup\n\nA canonical setup can be found here: [👉 `src/test/demo-app`👈 ](https://github.com/garronej/clean-architecture/tree/main/src/test/demo-app).\n\n## Enterprise grade app\n\nYou can consult the source code of [onyxia-web](https://github.com/InseeFrLab/onyxia-web) to see how `clean-architecture` is used in a real world application.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/InseeFrLab/onyxia\"\u003e\n  \u003ci\u003eOnyxia: A data science-oriented container launcher.\u003c/i\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/6702424/231329083-180fe7a2-22a8-470f-910a-ef66300b6f35.png\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# Starting the demo app\n\n```bash\ngit clone https://github.com/garronej/clean-architecture\ncd clean-architecture\nyarn\nyarn build\nyarn start-demo-app\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarronej%2Fclean-architecture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgarronej%2Fclean-architecture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarronej%2Fclean-architecture/lists"}