https://github.com/metarhia/Example

Metarhia application example for Node.js 🟢
https://github.com/metarhia/Example

api cloud cluster isolation metarhia metaserverless node nodejs project sandboxing server starter-kit threads

Last synced: 7 days ago
JSON representation

Metarhia application example for Node.js 🟢

• Host: GitHub
• URL: https://github.com/metarhia/Example
• Owner: metarhia
• License: mit
• Created: 2020-04-30T20:48:23.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-26T06:36:06.000Z (16 days ago)
• Last Synced: 2024-06-26T07:48:43.514Z (16 days ago)
• Topics: api, cloud, cluster, isolation, metarhia, metaserverless, node, nodejs, project, sandboxing, server, starter-kit, threads
• Language: JavaScript
• Homepage: https://metarhia.com
• Size: 4.27 MB
• Stars: 198
• Watchers: 22
• Forks: 74
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Lists

• awesome-stars - Example

README

        
# Metarhia application example for Node.js

[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/metarhia/Example/blob/master/LICENSE)

[🚀 Metarhia documentation and starter's guide](https://github.com/metarhia/Docs)

## Concept

This is a logical continuation of

[Node.js Starter Kit](https://github.com/HowProgrammingWorks/NodejsStarterKit)

moving all system code to dependencies, namely using

[Metarhia technology stack](https://github.com/metarhia).

The purpose of this starter kit is to show best practices for Metarhia and

Metaserverless, to give structure and architecture example, to illustrate

simplicity and efficiency of mentioned technologies.

All parts of this implementation are optimized for reliability, scalability,

performance and security. So if you need readability and want to study code,

let's start with

[Node.js Starter Kit](https://github.com/HowProgrammingWorks/NodejsStarterKit).

## Feature list

- Serve API with auto routing, HTTP(S), WS(S)

- Server code live reload with file system watch

- Auto dependency loader and plugins

- Graceful shutdown and application reload

- Minimum code size and dependencies

- Code sandboxing for security and context isolation

- Multi-threading for CPU utilization and isolation

- Serve multiple ports in threads

- Serve static files with memory cache

- Application configuration

- Simple logger and redirection from console

- Database access layer (Postgresql)

- Client persistent sessions

- Unit-tests and API tests example

- Request queue timeout and size

- API parallel execution concurrency

- API method execution timeout

- Load balancing for scaling

- Prototype pollution prevention

- Better code isolation

## Usage

- You need node.js 18.x or 20.x

- Fork and clone this repository (optionally subscribe to repo changes)

- Run `npm i` to install dependencies and generate RSA certificate

- Remove unneeded dependencies if your project doesn't require them

- Add your license to `LICENSE` file but don't remove starter kit license

- Start your project modifying this starter kit

- If you have Docker and Docker Compose installed to run the project, use the command: `docker-compose up`

- Before running server initialize the DB:

  - First of all, make sure you have PostgreSQL installed (preferably 12.x to 16.x).

  - Run database initialization script: `database/setup.sh`

- Run project: `node server.js` and stop with Ctrl+C

- Ask questions in Telegram https://t.me/nodeua (node.js related) or

  https://t.me/metaserverless (metarhia related)

## License

Copyright (c) 2020-2024 Metarhia contributors.

This starter kit is [MIT licensed](./LICENSE).