{"id":21499238,"url":"https://github.com/inversiland/inversiland","last_synced_at":"2025-10-09T19:43:27.525Z","repository":{"id":187468814,"uuid":"676140233","full_name":"inversiland/inversiland","owner":"inversiland","description":"🎡 InversifyJS framework to manage dependencies elegantly.","archived":false,"fork":false,"pushed_at":"2024-12-19T14:28:16.000Z","size":1811,"stargazers_count":41,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-01T11:51:57.087Z","etag":null,"topics":["dependency-injection","dependency-injection-container","dependency-injection-framework","extenject","inversify","inversifyjs","inversion-of-control","ioc","ioc-container","nestjs","ninject","solid","typescript","zenject"],"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/inversiland.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":["carlossalasamper"],"buy_me_a_coffee":"carlossala95"}},"created_at":"2023-08-08T14:16:32.000Z","updated_at":"2025-06-25T23:32:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"dc0c5845-3ff1-4135-ac8b-01703f37c3c0","html_url":"https://github.com/inversiland/inversiland","commit_stats":{"total_commits":34,"total_committers":2,"mean_commits":17.0,"dds":0.02941176470588236,"last_synced_commit":"4734ce2c9c7b79b09f7705d9dabe5ff20af15b53"},"previous_names":["carlossalasamper/inversify-sugar","carlossalasamper/inversiland","inversiland/inversiland"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/inversiland/inversiland","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inversiland%2Finversiland","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inversiland%2Finversiland/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inversiland%2Finversiland/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inversiland%2Finversiland/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/inversiland","download_url":"https://codeload.github.com/inversiland/inversiland/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inversiland%2Finversiland/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266824293,"owners_count":23990208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"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":["dependency-injection","dependency-injection-container","dependency-injection-framework","extenject","inversify","inversifyjs","inversion-of-control","ioc","ioc-container","nestjs","ninject","solid","typescript","zenject"],"created_at":"2024-11-23T17:15:04.485Z","updated_at":"2025-10-09T19:43:27.456Z","avatar_url":"https://github.com/inversiland.png","language":"TypeScript","funding_links":["https://github.com/sponsors/carlossalasamper","https://buymeacoffee.com/carlossala95","https://www.buymeacoffee.com/carlossala95"],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://www.npmjs.com/package/inversiland\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/inversiland.svg\" alt=\"NPM Version\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://www.npmjs.com/package/inversiland\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/npm/l/inversiland.svg\" alt=\"Package License\" /\u003e\u003c/a\u003e\r\n\r\n# Inversiland\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003cimg alt=\"Inversiland banner\" src=\"./assets/images/inversiland-cover.webp\" style=\"max-width: 1280px; width: 100%;\" /\u003e\r\n\u003c/p\u003e\r\n\u003cp align=\"center\" style=\"margin-top: 10px;\"\u003e 🎡 \u003ca href=\"https://inversify.io/\"\u003eInversifyJS\u003c/a\u003e framework to manage dependencies elegantly.\u003c/p\u003e\r\n\r\n## Table of Contents\r\n\r\n- [Introduction](#introduction)\r\n- [Why Inversiland](#why-inversiland)\r\n- [Documentation](#documentation)\r\n- [Templates](#templates)\r\n- [Support the Project](#support-the-project)\r\n- [License](#license)\r\n\r\n## Introduction\r\n\r\nIn 2015, **Remo H. Jansen** gave birth to [InversifyJS](https://inversify.io/).\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003cimg alt=\"Inversiland banner\" src=\"./assets/images/inversify-founding-father.webp\" style=\"max-width: 800px; width: 100%;\" /\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\u003cq\u003eA powerful and lightweight inversion of control (IoC) container for JavaScript \u0026 Node.js apps powered by TypeScript.\u003c/q\u003e\u003c/p\u003e\r\n\r\nToday, **we thank our founding father for his work**, but we're not going to ask for permission to create the ultimate JavaScript dependency system on par with Angular's or NestJS's injectors [from a fork of Inversify](./packages/inversify/README.md).\r\n\r\n🎡 Welcome to Inversiland, the dependency system you've always dreamed of.\r\n\r\n## Why Inversiland\r\n\r\nLet's compare the most popular JavaScript dependency systems.\r\n\r\n### Angular\r\n\r\nAngular's injector allows us to relate the dependencies of one module to those of another through its import/export API.\r\n\r\n```typescript\r\n// (Angular) common.module.ts\r\n\r\nimport { NgModule } from \"@angular/core\";\r\nimport { Logger } from \"./logger\";\r\n\r\n@NgModule({\r\n  declarations: [Logger],\r\n  exports: [Logger],\r\n})\r\nexport class CommonModule {}\r\n```\r\n\r\n```typescript\r\n// (Angular) cats.module.ts\r\n\r\nimport { NgModule } from \"@angular/core\";\r\nimport { CommonModule } from \"./common.module\";\r\nimport { CatsController } from \"./cats.controller\";\r\nimport { CatsService } from \"./cats.service\";\r\n\r\n@NgModule({\r\n  imports: [CommonModule],\r\n  declarations: [CatsController, CatsService],\r\n})\r\nexport class CatsModule {}\r\n```\r\n\r\n```typescript\r\n// (Angular) app.module.ts\r\n\r\nimport { NgModule } from \"@angular/core\";\r\nimport { CatsModule } from \"./cats/cats.module\";\r\n\r\n@NgModule({\r\n  imports: [CatsModule],\r\n})\r\nexport class AppModule {}\r\n```\r\n\r\n### NestJS\r\n\r\nThe NestJS injector also features an import/export API between modules to share dependencies.\r\n\r\n```typescript\r\n// (NestJS) common.module.ts\r\n\r\nimport { Module } from \"@nestjs/common\";\r\nimport { Logger } from \"./logger\";\r\n\r\n@Module({\r\n  providers: [Logger],\r\n  exports: [Logger],\r\n})\r\nexport class CommonModule {}\r\n```\r\n\r\n```typescript\r\n// (NestJS) cats.module.ts\r\n\r\nimport { Module } from \"@nestjs/common\";\r\nimport { CommonModule } from \"./common.module\";\r\nimport { CatsController } from \"./cats.controller\";\r\nimport { CatsService } from \"./cats.service\";\r\n\r\n@Module({\r\n  imports: [CommonModule],\r\n  controllers: [CatsController],\r\n  providers: [CatsService],\r\n})\r\nexport class CatsModule {}\r\n```\r\n\r\n```typescript\r\n// (NestJS) app.module.ts\r\n\r\nimport { Module } from \"@nestjs/common\";\r\nimport { CatsModule } from \"./cats/cats.module\";\r\n\r\n@Module({\r\n  imports: [CatsModule],\r\n})\r\nexport class AppModule {}\r\n```\r\n\r\n### InversifyJS\r\n\r\nCompared to modern dependency system APIs, Inversify has a number of disadvantages:\r\n\r\n- ❌ Your have to create all the containers separately to scope the dependencies into modules (to build a hierarchical dependency system).\r\n- ❌ How do you plan to relate dependencies between containers without an import/export API?\r\n- ❌ There is no single entry point to initialize all the containers. They are initialized at the time the files that declare them are imported.\r\n\r\n```typescript\r\n// (Inversify) globalContainer.ts\r\n\r\nconst globalContainer = new Container();\r\n\r\n// Global bindings here\r\n\r\nexport globalContainer\r\n```\r\n\r\n```typescript\r\n// (Inversify) commonContainer.ts\r\n\r\nimport { globalContainer } from \"./globalContainer\";\r\nimport { Logger } from \"./Logger\";\r\n\r\nconst commonContainer = globalContainer.createChild();\r\n\r\ncommonContainer.bind(Logger).toSelf().inSingletonScope();\r\n\r\nexport commonContainer;\r\n```\r\n\r\n```typescript\r\n// (Inversify) catsContainer.ts\r\n\r\nimport { globalContainer } from \"./globalContainer\";\r\nimport { CatsController } from \"./CatsController\";\r\nimport { CatsService } from \"./CatsService\";\r\n\r\nconst catsContainer = globalContainer.createChild();\r\n\r\n// 😿 We can't import a subset of bindings from commonContainer\r\n\r\ncatsContainer.bind(CatsController).toSelf().inSingletonScope();\r\ncatsContainer.bind(CatsService).toSelf().inSingletonScope();\r\n\r\nexport catsContainer;\r\n```\r\n\r\n### Inversiland\r\n\r\n**Inversiland** is a framework built on top of Inversify with a clear objective: to offer an API on par with the most cutting-edge hierarchical dependency systems.\r\n\r\n```typescript\r\n// (Inversiland) CommonModule.ts\r\n\r\nimport { module } from \"inversiland\";\r\nimport { Logger } from \"./Logger\";\r\n\r\n@module({\r\n  providers: [Logger],\r\n  exports: [Logger],\r\n})\r\nexport class CommonModule {}\r\n```\r\n\r\n```typescript\r\n// (Inversiland) CatsModule.ts\r\n\r\nimport { module } from \"inversiland\";\r\nimport { CommonModule } from \"./CommonModule\";\r\nimport { CatsController } from \"./CatsController\";\r\nimport { CatsService } from \"./CatsService\";\r\n\r\n@module({\r\n  imports: [CommonModule],\r\n  providers: [CatsService, CatsController],\r\n})\r\nexport class CatsModule {}\r\n```\r\n\r\n```typescript\r\n// (Inversiland) AppModule.ts\r\n\r\nimport { module } from \"inversiland\";\r\nimport { CatsModule } from \"./CatsModule\";\r\n\r\n@module({\r\n  imports: [CatsModule],\r\n})\r\nexport class AppModule {}\r\n```\r\n\r\nFollow [the official guide to start using Inversiland](./documentation/GettingStarted.md).\r\n\r\n## Documentation\r\n\r\n- [Getting Started](./documentation/GettingStarted.md)\r\n- [Modules](./documentation/Modules.md)\r\n- [Injection](./documentation/Injection.md)\r\n- [Dynamic Modules](./documentation/DynamicModules.md)\r\n\r\n## Templates\r\n\r\nDon't start your Inversiland projects from scratch, choose a well-configured template.\r\n\r\n- [react-clean-architecture](https://github.com/carlossalasamper/react-clean-architecture)\r\n- [react-native-clean-architecture](https://github.com/carlossalasamper/react-native-clean-architecture)\r\n\r\n## Support the Project\r\n\r\nTo keep this open source project alive, community support is needed.\r\n\r\n- ⭐ Star the repository and share it with your coworkers.\r\n- 💲 Become a sponsor so we will invest more time improving the product.\r\n\r\n### Become a Sponsor\r\n\r\n\u003cp\u003e\u003ca href=\"https://www.buymeacoffee.com/carlossala95\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/default-orange.png\" alt=\"Buy Me A Coffee\" height=\"41\" width=\"174\"\u003e\u003c/a\u003e\u003c/p\u003e\r\n\r\n### Sponsors\r\n\r\n\u003cp\u003e\r\n  Become a sponsor of Inversiland through any platform to appear in this section.\r\n\u003c/p\u003e\r\n\r\n## License\r\n\r\nThe Inversiland source code is made available under the [MIT license](./LICENSE).\r\n\r\nSome of the dependencies are licensed differently, with the BSD license, for example.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finversiland%2Finversiland","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finversiland%2Finversiland","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finversiland%2Finversiland/lists"}