create-akkasls-entity

This repository provides the create-akkasls-entity tool to support Akka Serverless development with the npm/JavaScript toolchain.

Usage

This tool can be used to generate a project suitable for the general development of Akka Serverless applications.

There are two templates available to select from:

value-entity (default); provides the starting point to develop a Value Entity
event-sourced-entity; provides the starting point to develop an Event Sourced Entity

To create the initial codebase for a new entity with npm:

npx @lightbend/create-akkasls-entity@latest my-entity --template value-entity
cd my-entity
npm install
npm run build

Or using Yarn:

yarn create @lightbend/akkasls-entity@latest my-entity --template value-entity
cd my-entity
yarn
yarn build

This module will be included as a dependency of the created project, providing the akkasls-codegen-js tool binary for your platform.

To build and test locally, first install:

npm install

...then package:

npm pack

...and then install locally (substituting with the version that the above npm pack reports):

npm install -g lightbend-create-akkasls-entity-<some-version>.tgz

As the create-akkasls-entity command is now locally installed, you are able to run:

create-akkasls-entity my-entity