/node-base-hex

Base template for an nodeJS project with hexagonal architecture

Primary LanguageTypeScriptMIT LicenseMIT

Project Name

Node, Express, Typescript, Jest, Docker Hexagonal Architecture Template

Introduction

This is a template to run a node.js project that uses hexagonal architecture with docker

Installation and Usage

Using Docker

  1. Clone the Repository

    git clone git@github.com:andres-root/node-base-hex.git
  2. Build with Docker Compose

    Navigate to the project directory:

    cd [Your Project Directory]

    Build the project using Docker Compose:

    docker compose build
  3. Run the Project

    Run your project in detached mode:

    docker compose up -d

Running Tests

To run tests, follow these steps:

  1. Install Dependencies

    npm install
  2. Run Tests

    npm run test

Running Without Docker

To run the project without Docker, ensure the Docker backend instance is not running and that you are running a local PostgreSQL DB instance, then follow these steps:

  1. Install Dependencies

    npm install
  2. Start the Development Server

    npm run dev

Contributing

License