The development process is optimized for Blink-based browsers (Chromium, Google Chrome, Opera) and their developer tools.
The server-side CDN, CI-, Web-, and Websocket Stack though is only supporting Linux and Mac OSX due to sandboxing and cross-compilation reasons. Windows also can't support SPDY and WebSocket extensions without Ephermal Port issues.
Always remember, there's no client-side and server-side application code whatsoever, because all the network components can be used on either side and peer-to-peer. That means you can run a native build on Windows using the client-side and server-side stack.
1. Download lycheeJS
Download and install the newest stable release of NodeJS from nodejs.org.
Download lycheeJS via zip-file and extract its contents to ~/lycheeJS.
wget https://github.com/LazerUnicorns/lycheeJS/archive/master.zip; unzip lycheeJS-master.zip; mv lycheeJS-master ~/lycheeJS;
- Make sure the lycheeJS-master folder contained in the zip-file is renamed to lycheeJS to follow up with the tutorials.
2. Start lycheeJS
- After building the core, you are ready to go. Start Sorbet, the lycheeJS webserver:
user@box:~$ cd ~/lycheeJS; user@box:~/lycheeJS$ nodejs ./tool/configure.js; user@box:~/lycheeJS$ npm start;
- Open your Web Browser and navigate to http://localhost:8080 to open the lycheeJS welcome page. The shipped example projects show you best practices on how to develop cross-platform games.
3. Install Fertilizers (optional)
By default, lycheeJS ships with the HTML and NodeJS Fertilizers.
If you want more cross-compilation build targets, you need to run this command to install those from the lycheeJS-fertilizers repository:
user@box:~$ cd ~/lycheeJS; user@box:~/lycheeJS$ nodejs ./tool/install-fertilizers.js
4. Deployment on a Server (optional)
lycheeJS and Sorbet can also be integrated with your root server.
It is recommended to use the daemon setup on production environments and to use the npm setup on development environments.
The daemon setup integrates better with Debian / Ubuntu systems and features daily automatic updates with your git repository.
4.a) Daemon Setup
The profile parameter is equivalent to the available profiles in ~/lycheeJS/sorbet/profile/[profile.json]:
user@box:~$ cd ~/lycheeJS; user@box:~/lycheeJS$ sudo ./tool/ubuntu/install.js --profile=localhost.json; user@box:~$ sudo /etc/init.d/sorbet restart;
4.b) NPM Setup
You can modify the ~/lycheeJS/package.json/scripts section to use your own sorbet profile. Take a look at the examples localhost or lycheejs.org:
# This is identical to npm start, but will run forever user@box:~$ cd ~/lycheeJS; user@box:~/lycheeJS$ npm run-script localhost;
There are plenty of tutorials available at http://lycheejs.org/tutorials.
The documentation is available online at http://lycheejs.org/documentation/index.html.
You want to see what kind of fancy features will arrive next? Take a look at the ROADMAP.md file.
You want to contribute to the project? Take a look at the CONTRIBUTING.md file.
The only requirement for such a platform is a fully implemented bootstrap API.
These implementations are fully optional and only necessary if you are using them inside your Game or Application.
The lycheeJS framework is licensed under the MIT License. The projects and demos are licensed under the CC0 (public domain) License.