Silex core library

Core library of Silex — Node.js server, visual editor, npx CLI and Docker image. Powers the online editor, the desktop app and all Silex integrations.

Useful links

• Documentation for developers
• 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.

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:

yarn add -D @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 yarn run start:debug

Development

To contribute to this project:

1. Clone the Repository:

   git clone https://github.com/silexlabs/silex-lib.git
   cd silex-lib

2. Install Dependencies:

   yarn install

3. Build the Project:

   yarn run build

4. Start Development Server:

   yarn 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