Skip to content

jellydn/moleculer-typescript-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Welcome to moleculer-typescript-template πŸ‘‹

Version Prerequisite Twitter: jellydn

My Moleculer-based microservices project

Moleculer - Progressive microservices framework for Node.js

IT Man - Automating API Client Generation with openapi-ts

IT Man - Logdy Deep Dive: Streamlining Log Management with a Powerful Web UI

ITMan - Automate API Linting: Spectral Integration with VS Code and GitHub Actions

Prerequisites

  • node >= 18.17.x

Init new project

npx degit jellydn/moleculer-typescript-template [PROJECT-NAME]

Features

  • ⚑️ Progressive microservices framework for Node.js. Moleculer with Typescript template
  • πŸ“¦ hygen - The scalable code generator that saves you time.
  • 🦾 pino - super fast, all natural json logger
  • πŸ”₯ swagger-jsdoc - Generates swagger/openapi specification based on jsDoc comments and YAML files.
  • ✨ moleculer-zod-validator - A validator for the Moleculer microservice framework to allow the use of Zod.
  • πŸ” asteasolutions/zod-to-openapi - A library that generates OpenAPI (Swagger) docs from Zod schemas.
  • πŸͺ„ hey-api/openapi-ts - Turn your OpenAPI specification into a beautiful TypeScript client.

Install

pnpm install

Usage

# Copy env file
cp .env.example .env
pnpm dev

After starting, open the http://localhost:3000/ URL in your browser. On the welcome page you can test the generated services via API Gateway and check the nodes & services. https://gyazo.com/c8a8c8b05319504d36922458d9807db2.gif

pnpm cli --ns api

https://gyazo.com/235f710ab3fd906f80768261e793eb13

In the terminal, try the following commands:

  • nodes - List all connected nodes.
  • actions - List all registered service actions.
  • call greeter.hello - Call the greeter.hello action.
  • call greeter.welcome --username dunghd - Call the greeter.welcome action with the username parameter.

https://gyazo.com/3aca1c4e1992ad1c10da8060d7e21a6c.gif

This project uses hygen to generate code templates, saving you time and ensuring consistency across your codebase.

Adding a New Service

To add a new service to your project, use the following command:

pnpm generate:service [service-name]

Adding a New Action to a Service

To add a new action to an existing service, use the following command:

pnpm generate:action [action-name] --service [service-name]

Generating CRUD Services

To generate a service with Create, Read, Update, and Delete (CRUD) operations, use the following command:

pnpm generate:crud [service-name]

API Documentation

This template also reads your JSDoc-annotated source code and generates an OpenAPI (Swagger) specification.

Run the following command to generate the Swagger documentation:

pnpm generate:swagger

Open the http://localhost:3000/docs URL in your browser, you will see the Swagger UI as

https://gyazo.com/a4fe2413414c94dde636a531eee1a4a0.gif

Run tests

pnpm test

Deployment

This template comes with two GitHub Actions that handle automatically deploying your app to production and staging environments.

Prior to your first deployment, you'll need to do a few things:

  • Install Fly

  • Sign up and log in to Fly

    fly auth signup
  • Create two apps on Fly, one for staging and one for production:

    fly create moleculer-typescript
    fly create moleculer-typescript-staging
  • Create a new GitHub Repository

  • Add a FLY_API_TOKEN to your GitHub repo. To do this, go to your user settings on Fly and create a new token, then add it to your repo secrets with the name FLY_API_TOKEN.

Now that every is set up you can commit and push your changes to your repo. Every commit to your main branch will trigger a deployment to your production environment, and every commit to your dev branch will trigger a deployment to your staging environment.

GitHub Actions

We use GitHub Actions for continuous integration and deployment. Anything that gets into the main branch will be deployed to production after running tests/build/etc. Anything in the dev branch will be deployed to staging.

Useful links

NPM scripts

  • pnpm dev: Start development mode (load all services locally with hot-reload & watch)
  • pnpm start: Start production mode (set SERVICES env variable to load certain services)
  • pnpm cli: Start a CLI and connect to production. Don't forget to set production namespace with --ns argument in script
  • pnpm ci: Run continuous test mode with watching
  • pnpm test: Run tests & generate coverage report
  • pnpm dc:up: Start the stack with Docker Compose
  • pnpm dc:down: Stop the stack with Docker Compose

Pre-commit hooks

This template uses Pre-commit to run checks before you commit your code. This ensures that your code is formatted correctly and passes all tests before you push it to your repository.

pre-commit install

To run the checks manually, use the following command:

pre-commit run --all-files

Author

πŸ‘€ Dung Huynh

Show your support

Star History Chart

Give a ⭐️ if this project helped you!

kofi paypal buymeacoffee