{"id":14989472,"url":"https://github.com/faytranevozter/nodejs-api-starter","last_synced_at":"2025-10-24T21:41:55.356Z","repository":{"id":42673457,"uuid":"324983287","full_name":"faytranevozter/nodejs-api-starter","owner":"faytranevozter","description":"Very basic NodeJS Api Service app","archived":false,"fork":false,"pushed_at":"2025-04-09T13:28:23.000Z","size":593,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-19T06:12:17.170Z","etag":null,"topics":["api","boilerplate","flow","hotfix","javascript","koa","koajs","koajs-starter-template","microservice","mongodb","node","nodejs","service","staging","starter"],"latest_commit_sha":null,"homepage":"","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/faytranevozter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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-12-28T10:38:58.000Z","updated_at":"2024-09-17T01:53:10.000Z","dependencies_parsed_at":"2025-04-12T01:24:59.455Z","dependency_job_id":null,"html_url":"https://github.com/faytranevozter/nodejs-api-starter","commit_stats":{"total_commits":32,"total_committers":3,"mean_commits":"10.666666666666666","dds":0.5,"last_synced_commit":"82ba838a6ef143266c004b37092b26d012afe4ef"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/faytranevozter/nodejs-api-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faytranevozter%2Fnodejs-api-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faytranevozter%2Fnodejs-api-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faytranevozter%2Fnodejs-api-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faytranevozter%2Fnodejs-api-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faytranevozter","download_url":"https://codeload.github.com/faytranevozter/nodejs-api-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faytranevozter%2Fnodejs-api-starter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269706664,"owners_count":24462208,"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-08-10T02:00:08.965Z","response_time":71,"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":["api","boilerplate","flow","hotfix","javascript","koa","koajs","koajs-starter-template","microservice","mongodb","node","nodejs","service","staging","starter"],"created_at":"2024-09-24T14:18:25.402Z","updated_at":"2025-10-24T21:41:50.319Z","avatar_url":"https://github.com/faytranevozter.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## ⛩ **NodeJS Starter**\n\n### **`About this repository 😎`**\nThis repository talks about how to build an outstanding web server using latest Javascript technologies that can help micro entrepreneurs swiftly reach economic freedom.\n\n### **`Engine Requirement 🚜`**\n```\n  -- Node.js v16.x or v18.x\n  -- NPM v8+\n```\n\n### **`Technology Stacks 🍔`**\n```\n  -- Node.js\n  -- Koa.js (Express.js Godfather) 🔥🔥\n  -- Morgan (for logging purposes)\n  -- Mongodb 💾\n```\n\n### **`Project Structures 🏢`**\n```\n.\n│── README.md\n│── .env.example  (this will be the environment file)\n|── .gitignore\n|── package.json\n|── index.js     (entry point)\n└── controllers/\n|   └── ...[.js]\n└── helpers/\n|   └── ...[.js]\n└── libraries/\n|   └── ...[.js]\n└── middlewares/\n|   └── ...[.js]\n└── repositories/\n|   └── ...[.js]\n└── routes/\n|   └── ...[.js]\n└── services/\n|   └── ...[.js] (db connection or third party api)\n```\n\n### **`Install Localy 🧑🏼‍🔧`**\n1. install dependency. `npm install`  \n1. copy .env.example and rename it into .env (`cp .env.example .env`)\n1. ajust config in .env\n\n### **`Running App 👟`**\n`npm start`  \n\n### **`Flow Development 🏗`**\nDuring the development cycle, a variety of supporting branches are used:  \n\n- feature/* -- feature branches are used to develop new features for the upcoming releases. May branch off from develop and must merge into develop.\n- hotfix/* -- hotfix branches are necessary to act immediately upon an undesired status of master. May branch off from master and must merge into master and develop.\n\nCreating a new feature  \n\n1. create new branch from master. ex: `feature/name-of-feature`.\n1. write your code.\n1. don't forget to run `npm run lint` to check standardize code or `npm run lintfix` to auto fix non-standard code.\n1. commit \u0026 push your work to the same named branch on the server.\n1. create PR into development branch for testing in dev server.\n1. if its pre-production ready then create PR from the same branch into staging. **DON'T PR FROM DEVELOPMENT BRANCH!**\n1. if ready to production then create PR from the same branch into master/production. **DON'T PR FROM DEVELOPMENT BRANCH OR STAGING!**\n\n### **`Deployment 🚀`**\nThis flow of deployment using Git Flow with 3 main branches  \n\n- master -- this branch contains production code. All development code is merged into master in sometime.\n- staging -- this branch is a nearly exact replica of a production environment for software testing.\n- development/dev -- this branch contains pre-production code. When the features are finished then they are merged into develop.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaytranevozter%2Fnodejs-api-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaytranevozter%2Fnodejs-api-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaytranevozter%2Fnodejs-api-starter/lists"}