This repository is the core library of Silex, it is a nodejs server which serves the Silex editor and the websites created with Silex. The core library is used in the online version of Silex, in the desktop app, and in the nodejs integration. It is available as a npx cli, as a docker image, and as a npm/nodejs library.
Useful links
- npm package for this repo
- Docker image for this repo
- Official website
- Road map (please help defining tasks and prioritising)
- Bug report in Github issues
- Forums in Github discussions
- Silex meta package with more source code
Help make Silex sustainable by being part of the community, contributing documentation, making a financial contribution, report bugs.
The easiest way to start using Silex is by using the online version provided by Silex Labs foundation. Simply visit v3.silex.me and start building your website right away.
There is a desktop application that you can install on your computer which may be faster since it uses your local files and it works offline. You can download the desktop app from the Silex desktop repository.
You can also run Silex locally or on your server using npx, npm, or Docker.
Check the developer docs for configuration options and integration with your js projects.
npx @silexlabs/silexThis command will run Silex with default config.
docker run -p 6805:6805 silexlabs/silexThis command will run Silex in a Docker container.
First, install Silex as a dev dependency in your project:
npm install --save-dev @silexlabs/silexThen, you can run Silex with the silex command in your package.json scripts:
{
"scripts": {
"start": "silex"
}
}You can configure Silex using environment variables and command-line options. All available options can be found in the developer docs as well as in the code: src/ts/server/cli.ts.
Check the example config files - which are the same as plugins in Silex, in the examples/ folder. To test these configs, start Silex locally like this:
$ npx silex --client-config=./examples/client-config-transformers.js --server-config=`pwd`/examples/server-config-plugins.js Or like this:
$ SILEX_CLIENT_CONFIG=./examples/client-config-transformers.js SILEX_SERVER_CONFIG=`pwd`/examples/server-config-plugins.js npm run start:debugContributions are welcome! Please read our contributing guidelines for details on how to contribute to Silex.
Silex is free and open-source software licensed under the GPL-3.0.
The upstream projects we use in Silex are all listed in Silex meta package