This is the repository of the lively.next project.
You can install lively.next "natively" on your system or use Docker for your development environment. Please note, that these instructions currently are are not recommended for openly deploying lively.next in the web!
Currently, the MacOS, Linux, and the Linux Subsystem for Windows are supported. Make sure you have the following software installed.
- node.js version 17 or later
- git
For some more advanced development operations (bulk testing from the command line), you will also need
sedorgsedon MacOsssornetstaton MacOsperlpython3withsultaninstalledbrotliaspell.
- Clone this repository and run the
install.shscript. This will install the necessary dependencies. Please note, that this process will take a few minutes. - Run the
start.shscript. - Lively will now be running on your local computer at http://localhost:9011.
Usually, running start.sh will now be enough to get you going again. When changes resulted in changed dependencies, you will need to run install.sh again, making it a good first step when troubleshooting.
For a more platform agnostic variant and less need for local dependencies, you can also use a setup based on docker.
Having docker, git (,and make) installed are the only prerequisites.
- Clone this repository
- Run
make docker-buildfrom the root of this repository.
This process takes a while, ending with a running lively server at http://localhost:9011.
When opting for the docker based approach, you can still use git as usual from your file system.
Afterwards, you can stop the lively server with make docker-stop.
docker-build has the same role as install.sh above. To just start your server in the future, you can execute make docker-start.
Since this will lead to a running server without logging in your shell by default, you can use make docker-watch to see the current output of your lively server.
make docker-bash will open a shell inside of the container running your server.
On Linux and Windows machines, both of the aforementioned options should usually coexist happily.
This means, that you can use start.sh and make docker-start both, independent of the initial means of installation.
On macs with Apple Silicon, this does not hold. When switching on such a machine, you will need to remove the next-node_modules/leveldown directory and run install.sh/make docker-build again.
Some hints and documentation can be found in the project wiki.
The actual documentation can be found here.
Please make sure to run make hooks from the root of the repository before starting to develop.
This project is MIT licensed.