The following assumes that you have completed the steps for setting up your local environment as well as creating an account and project. If you have not done this you must follow the instructions here:
- Setting Up your Machine
- as well as the Developer prerequisites
- Install nvm (node version manager)
- We recommend v0.34.0 or later. (Check with
nvm --version
)
- We recommend v0.34.0 or later. (Check with
- Install npm (node package manager)
- We recommend v6.14.3 or later. (Check with
npm -v
)
- We recommend v6.14.3 or later. (Check with
- You also need to install the protobuf compiler.
- We recommend using v3.0.0 or later. (Check with
protoc --version
) - Mac OS X
brew install protobuf
- Linux
sudo apt install protobuf-compiler
- Or alternatively (src and bins)
- We recommend using v3.0.0 or later. (Check with
- Your Lightbend Cloudstate Account
- Creating a Project
Grab the sample application from github:
https://github.com/lightbend/cloudstate-samples
Event sourced example with PostgreSQL statefulstore
. Simple shop front end to interact with.
CRDT chat with simple front end web interface, friends storage, and presence state.
Event sourced example with PostgreSQL statefulstore
. This example provides a back-end service that implements a shopping cart like functionality, allowing for requests to be send against it in order to store, retrieve and delete data.
We pick up node.js version 12 as default in all node.js related projects. Based on node.js website, currently version 12 is recommended for most users. Based on node.js release page, the odd number release has only 6 months support cycle, so we don't set it as default. If you plan to try the different node.js version in sample projects, you can
- modify
.nvmrc
file, so commandnvm install
andnvm use
will pick up the node.js version you set. - modify
package.json
file, especially "engineStrict" and "engines.node" fields. It affects the version check when runningnpm install
The license is Apache 2.0, see LICENSE-2.0.txt.
This project is NOT supported under the Lightbend subscription.
This project is maintained mostly by @coreyauger and @cloudstateio.
Feel free to ping above maintainers for code review or discussions. Pull requests are very welcome–thanks in advance!