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
sed
orgsed
on MacOsss
ornetstat
on MacOsperl
python3
withsultan
installedbrotli
aspell
.
- Clone this repository and run the
install.sh
script. This will install the necessary dependencies. Please note, that this process will take a few minutes. - Run the
start.sh
script. - 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-build
from 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.