{"id":24112825,"url":"https://github.com/Murzbul/node-experience","last_synced_at":"2025-09-18T01:32:10.092Z","repository":{"id":40339254,"uuid":"244355387","full_name":"Murzbul/node-experience","owner":"Murzbul","description":"Hello! NExp (Node Experience) is a boilerplate for Node, which makes use of a Hexagonal architecture, in addition to all the power of TypeScript that combined allow a perfect cohesion thus achieving a clean and at the same time very powerful implementation.","archived":false,"fork":false,"pushed_at":"2025-07-22T07:31:47.000Z","size":76430,"stargazers_count":53,"open_issues_count":7,"forks_count":33,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-07-31T14:35:15.655Z","etag":null,"topics":["boilerplate-application","docker","innovation-labx","mongodb","nodejs","typescript"],"latest_commit_sha":null,"homepage":"https://nexp.docs.digichanges.com","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/Murzbul.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}},"created_at":"2020-03-02T11:35:47.000Z","updated_at":"2025-04-15T00:00:55.000Z","dependencies_parsed_at":"2023-02-09T21:01:09.760Z","dependency_job_id":"c0f0e179-17fc-47cf-bbb9-a8a37a1a75dd","html_url":"https://github.com/Murzbul/node-experience","commit_stats":null,"previous_names":["murzbul/node-experience","digichanges/node-experience"],"tags_count":151,"template":false,"template_full_name":null,"purl":"pkg:github/Murzbul/node-experience","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Murzbul%2Fnode-experience","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Murzbul%2Fnode-experience/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Murzbul%2Fnode-experience/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Murzbul%2Fnode-experience/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Murzbul","download_url":"https://codeload.github.com/Murzbul/node-experience/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Murzbul%2Fnode-experience/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275695789,"owners_count":25511349,"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-17T02:00:09.119Z","response_time":84,"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":["boilerplate-application","docker","innovation-labx","mongodb","nodejs","typescript"],"created_at":"2025-01-11T04:00:24.114Z","updated_at":"2025-09-18T01:32:09.628Z","avatar_url":"https://github.com/Murzbul.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Welcome to Node Experience!\n\n[![Sonarcloud Status](https://sonarcloud.io/api/project_badges/measure?project=DigiChanges_node-experience\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=Your_Project_Key)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://github.com/DigiChanges/node-experience/blob/master/LICENSE)\n\n\u003cdiv style=\"text-align:center\"\u003e\n    \u003cimg width=\"125\" src=\"nexp.svg\" alt=\"logo NExp\"\u003e\n\u003c/div\u003e\n\n## Basic Description\nHello! **NExp** *(Node Experience)* is a boilerplate for [**Node**](https://nodejs.org/en/), which makes use of a Clean Architecture + DDD, with [**TypeScript**](https://www.typescriptlang.org/) that combined allow a perfect cohesion thus achieving a clean and at the same time very powerful implementation.\n\n## Base project\n\nhttps://github.com/DigiChanges/node-experience\n\n## Docs\n\n### Boilerplate Documentation\n\n[Boilerplate Documentation](https://digichanges.github.io/nexp-docs)\n\n*NOTE*: The v1 it's deprecated and don't have support in the future.\n\n## Quick Start\n\nWe can run the project directly with docker compose and then bash where the basic commands to feed the database are located.\n\n1. git clone https://github.com/DigiChanges/node-experience\n2. Create a folder on project root call it `dist`.\n3. Install dependencies. `pnpm install`.\n4. Copy `.env.dev` file to `.env`. (**.env.dev** it's an environment example file)\n5. Then execute `STAGE=dev docker-compose up --build` to up all containers.\n\n`docker-compose exec node bash dev.init.sh`\n\n## Installation\n\nFirst, install nexp-cli using [npm](https://www.npmjs.com/) (we assume you have pre-installed [node.js](https://nodejs.org/)).\n\n```bash\nnpm install -g nexp-cli\n```\n\nThen generate your new project:\n\n```bash\nnexp-cli create\n```\n\nEach module is divided by business domain:\n\n- Item\n- Notification\n\nThere are also two particular cases:\n\n- Config\n- Shared\n\nThe directory structures for business domains are as follows: \n\n**Folder structure of a domain (business logic)**\n\n```sh \n├── Domain\n│   ├── Entities\n│   ├── Exceptions\n│   └── Services\n│   └── UseCases\n├── Infrastructure\n│   ├── Repositories\n│   ├── Schema\n│   └── Seeds\n├── Presentation\n│   ├── Commands\n│   ├── Controllers\n│   ├── Criterias\n│   ├── Exceptions\n│   ├── Handlers\n│   ├── Middlewares\n│   ├── Requests\n│   └── Transformers\n├── Tests\n│   ├── Fixtures\n ```\n\n---\n\n\u003e **Tip** I know it may sound repetitive, but it is not a framework. NExp is a set of tools or libraries working together through a common structure. All structural code within this project is not fixed and can be changed freely.\n\n### Supabase integration\n\nIn the infrastructure folder there is a file called `supabase_permissions.sql` this file is used to manage permissions \nwith these tables.\n\n* roles\n* permissions\n* users_has_roles\n* roles_has_permissions\n\nAnd a function call `get_authorization`\n\n## Advantages\n\nThe advantages of using this boilerplate are\nto save time thinking about certain basic structures common to any project to make an API\nwithout having to get everything from scratch. \n\nAs it is only a boilerplate, you have the freedom to structure the code whatever you want.\n\nCommon structures found within this project are: \n\n- Fastify's integration.\n- MikroORM and Mongoose Integration.\n- Basic push Notification and Email with nodemailer.\n- Business logic independent of the HTTP and persistence libraries.\n- Supabase integration middleware.\n\n## Quick Test\n\n### Execute TEST Environment\n\nTo run the tests, we need to install the packages and transpile the code, we also need the `.env` environment variable to exist.\n\n```bash\npnpm test\n```\n\n## Test different folder\n\n```bash\npnpm test src/[Module]/Tests\n```\n\nExample Unique Test\n\n```bash\npnpm test src/Item/Tests\n```\n\n## Docs\n[POSTMAN Documentation](https://documenter.getpostman.com/view/22552353/2s9YeBftt9)\n\n## License\n\n**NExp** is [MIT licensed](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMurzbul%2Fnode-experience","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMurzbul%2Fnode-experience","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMurzbul%2Fnode-experience/lists"}