{"id":13493522,"url":"https://github.com/metarhia/Example","last_synced_at":"2025-03-28T11:32:52.946Z","repository":{"id":39672457,"uuid":"260315441","full_name":"metarhia/Example","owner":"metarhia","description":"Metarhia application example for Node.js 🟢","archived":false,"fork":false,"pushed_at":"2025-03-15T07:44:27.000Z","size":4467,"stargazers_count":205,"open_issues_count":27,"forks_count":75,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-03-27T13:11:22.494Z","etag":null,"topics":["api","cloud","cluster","isolation","metarhia","metaserverless","node","nodejs","project","sandboxing","server","starter-kit","threads"],"latest_commit_sha":null,"homepage":"https://metarhia.com","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/metarhia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"patreon":"tshemsedinov"}},"created_at":"2020-04-30T20:48:23.000Z","updated_at":"2025-03-24T13:47:26.000Z","dependencies_parsed_at":"2023-09-26T19:58:52.274Z","dependency_job_id":"ba454403-bac5-4c2c-8e43-b3cf95ca1718","html_url":"https://github.com/metarhia/Example","commit_stats":null,"previous_names":[],"tags_count":9,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metarhia%2FExample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metarhia%2FExample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metarhia%2FExample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metarhia%2FExample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/metarhia","download_url":"https://codeload.github.com/metarhia/Example/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246021483,"owners_count":20710943,"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","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","cloud","cluster","isolation","metarhia","metaserverless","node","nodejs","project","sandboxing","server","starter-kit","threads"],"created_at":"2024-07-31T19:01:16.096Z","updated_at":"2025-03-28T11:32:52.926Z","avatar_url":"https://github.com/metarhia.png","language":"JavaScript","readme":"# Metarhia application example for Node.js\n\n[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/metarhia/Example/blob/master/LICENSE)\n\n[🚀 Metarhia documentation and starter's guide](https://github.com/metarhia/Docs)\n\n## Concept\n\nThis is a logical continuation of\n[Node.js Starter Kit](https://github.com/HowProgrammingWorks/NodejsStarterKit)\nmoving all system code to dependencies, namely using\n[Metarhia technology stack](https://github.com/metarhia).\n\n\u003c!--\nYou can begin development from this starter kit but having in mind future\nproduction deployment and further moving application to\n[Metaserverless cloud](https://github.com/Metaserverless) based on Metarhia\ntechnology stack and Node.js.\n--\u003e\n\nThe purpose of this starter kit is to show best practices for Metarhia and\nMetaserverless, to give structure and architecture example, to illustrate\nsimplicity and efficiency of mentioned technologies.\n\nAll parts of this implementation are optimized for reliability, scalability,\nperformance and security. So if you need readability and want to study code,\nlet's start with\n[Node.js Starter Kit](https://github.com/HowProgrammingWorks/NodejsStarterKit).\n\n## Feature list\n\n- Serve API with auto routing, HTTP(S), WS(S)\n- Server code live reload with file system watch\n- Auto dependency loader and plugins\n- Graceful shutdown and application reload\n- Minimum code size and dependencies\n- Code sandboxing for security and context isolation\n- Multi-threading for CPU utilization and isolation\n- Serve multiple ports in threads\n- Serve static files with memory cache\n- Application configuration\n- Simple logger and redirection from console\n- Database access layer (Postgresql)\n- Client persistent sessions\n- Unit-tests and API tests example\n- Request queue timeout and size\n- API parallel execution concurrency\n- API method execution timeout\n- Load balancing for scaling\n- Prototype pollution prevention\n- Better code isolation\n\n## Usage\n\n- You need node.js 18.x or 20.x\n- Fork and clone this repository (optionally subscribe to repo changes)\n- Run `npm i` to install dependencies and generate RSA certificate\n- Remove unneeded dependencies if your project doesn't require them\n- Add your license to `LICENSE` file but don't remove starter kit license\n- Start your project modifying this starter kit\n- If you have Docker and Docker Compose installed to run the project, use the command: `docker-compose up`\n- Before running server initialize the DB:\n  - First of all, make sure you have PostgreSQL installed (preferably 12.x to 16.x).\n  - Run database initialization script: `database/setup.sh`\n- Run project: `node server.js` and stop with Ctrl+C\n- Ask questions in Telegram https://t.me/nodeua (node.js related) or\n  https://t.me/metaserverless (metarhia related)\n\n## License\n\nCopyright (c) 2020-2024 Metarhia contributors.\nThis starter kit is [MIT licensed](./LICENSE).\n","funding_links":["https://patreon.com/tshemsedinov"],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetarhia%2FExample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetarhia%2FExample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetarhia%2FExample/lists"}