Brought to you by Alex Hoyau and Silex contributors.

Help make Silex sustainable by being part of the community, contributing documentation, making a financial contribution, report bugs.

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

Silex core library

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.

Getting Started

Online Version

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.

Desktop App (beta)

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.

Local or Server Installation

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.

Using npx

npx @silexlabs/silex

This command will run Silex with default config.

Using Docker

docker run -p 6805:6805 silexlabs/silex

This command will run Silex in a Docker container.

Using npm

First, install Silex as a dev dependency in your project:

npm install --save-dev @silexlabs/silex

Then, you can run Silex with the silex command in your package.json scripts:

{
  "scripts": {
    "start": "silex"
  }
}

Configuration

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:debug

Contributing

Contributions are welcome! Please read our contributing guidelines for details on how to contribute to Silex.

License

Silex is free and open-source software licensed under the GPL-3.0.

Dependencies

The upstream projects we use in Silex are all listed in Silex meta package

Github stars history