{"id":20348506,"url":"https://github.com/onebeyond/generator-systemic","last_synced_at":"2025-09-10T16:41:00.060Z","repository":{"id":39060006,"uuid":"75550255","full_name":"onebeyond/generator-systemic","owner":"onebeyond","description":"A yeoman-based template to generate a systemic microservice","archived":false,"fork":false,"pushed_at":"2023-07-20T06:23:37.000Z","size":1054,"stargazers_count":24,"open_issues_count":53,"forks_count":9,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-09-02T15:03:13.173Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/onebeyond.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}},"created_at":"2016-12-04T16:43:14.000Z","updated_at":"2023-01-27T08:13:40.000Z","dependencies_parsed_at":"2024-11-14T22:21:05.968Z","dependency_job_id":"379ff1ea-f40e-4d59-be78-ab513a3b400a","html_url":"https://github.com/onebeyond/generator-systemic","commit_stats":null,"previous_names":[],"tags_count":8,"template":true,"template_full_name":null,"purl":"pkg:github/onebeyond/generator-systemic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onebeyond%2Fgenerator-systemic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onebeyond%2Fgenerator-systemic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onebeyond%2Fgenerator-systemic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onebeyond%2Fgenerator-systemic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/onebeyond","download_url":"https://codeload.github.com/onebeyond/generator-systemic/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onebeyond%2Fgenerator-systemic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274487550,"owners_count":25294560,"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-09-10T02:00:12.551Z","response_time":83,"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":["hacktoberfest"],"created_at":"2024-11-14T22:20:57.411Z","updated_at":"2025-09-10T16:40:59.991Z","avatar_url":"https://github.com/onebeyond.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CI](https://github.com/guidesmiths/generator-systemic/actions/workflows/ci.yml/badge.svg)](https://github.com/guidesmiths/generator-systemic/actions/workflows/ci.yml)\n[![CD](https://github.com/guidesmiths/generator-systemic/actions/workflows/cd.yml/badge.svg)](https://github.com/guidesmiths/generator-systemic/actions/workflows/cd.yml)\n[![Maintainability](https://api.codeclimate.com/v1/badges/357d68163ad88770f74a/maintainability)](https://codeclimate.com/github/onebeyond/generator-systemic/maintainability)\n[![Test Coverage](https://api.codeclimate.com/v1/badges/357d68163ad88770f74a/test_coverage)](https://codeclimate.com/github/onebeyond/generator-systemic/test_coverage)\n\n# GENERATOR-SYSTEMIC\n\n\u003e A generator for a systemic microservice.\n\n\n### Systemic microservice\n\nAn easy and unopinionated implementation of a microservice fostering an inner [Hexagonal Architecture (Ports and Adapters)](https://en.wikipedia.org/wiki/Hexagonal_architecture_(software)).\n\n#### Main concepts\n- [__Systemic__](https://www.npmjs.com/package/systemic): dependecy injection orchestrator in charge of correctly start and stop the different components of the microservice.\n- __Systemic microservice__: a system composed of different sub-systems --\u003e _components_ and _sub-components_.\n- __Components__ and __sub-components__: minimal responsability elements (Adapters) of the system in charge of dealing with a given Port (generally speaking).\n\n\n# INSTALLATION\n\nFirst, install [Yeoman](http://yeoman.io) and generator-systemic using [npm](https://www.npmjs.com/) (we assume you have pre-installed [node.js](https://nodejs.org/)).\n\n```bash\nnpm install -g yo\nnpm install -g generator-systemic\n```\n\n### Getting To Know Yeoman\n\n * Yeoman has a heart of gold.\n * Yeoman is a person with feelings and opinions, but is very easy to work with.\n * Yeoman can be too opinionated at times but is easily convinced not to be.\n * Feel free to [learn more about Yeoman](http://yeoman.io/).\n\n\n# USAGE\n\nGenerate your new systemic project: a white canvas into which creating the components you do prefer according to your specifi business logic.\n\n[More info](generators/app/templates/root/_README.md)\n\n```bash\nmkdir my-service\ncd my-service\nyo systemic\n```\n\n## White canvas VS showcase\nThere is an option that can be passed to the generator at execution time using the flag `--showcase`. \n\n### `--showcase` flag NOT used\nGenerates your new systemic project: a white canvas into which creating the components you do prefer according to your specific business logic. \n\nMore info in the generated ReadMe.\n\n### `--showcase` flag used\nGenerates your new systemic project with extra components: a not so white canvas with a given business logic already in place to help you better understand how to handle components (and sub-components):\n- versioning.\n- workflows.\n- testing.\n- systemic ecosystem npm handy modules (e.g. [systemic-rabbitmq](https://www.npmjs.com/package/systemic-rabbitmq) - [systemic-mongdb](https://www.npmjs.com/package/systemic-mongodb)).\n\nMore info in the generated ReadMe.\n\n# CONTRIBUTING\nConsider following these guidelines if you want to contribute:\n\n- Feature: [https://github.com/guidesmiths/generator-systemic/issues/new](https://github.com/guidesmiths/generator-systemic/issues/new?assignees=\u0026labels=\u0026template=feature_request.md\u0026title=My%20Awesome%20Feature)\n- Bug: [https://github.com/guidesmiths/generator-systemic/issues/new](https://github.com/guidesmiths/generator-systemic/issues/new?assignees=\u0026labels=\u0026template=bug_report.md\u0026title=My%20Awesome%20Bug)\n\n- Pull Request: [https://github.com/guidesmiths/generator-systemic/blob/master/.github/pull_request_template.md](https://github.com/guidesmiths/generator-systemic/blob/master/.github/pull_request_template.md)\n\n\n# LICENSE\n\nMIT © [Guidesmiths Ltd](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonebeyond%2Fgenerator-systemic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonebeyond%2Fgenerator-systemic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonebeyond%2Fgenerator-systemic/lists"}