Silex Developer Guide

This document is a work in progress, we need your help, ask questions in the issues and add info here please

Related pages:

• About Silex (readme)
• Contribute
• How to Host An Instance of Silex
• Create templates for Silex
• Create Silex components
• Silex for hosting providers
• Silex source code repository, master and develop branches

Build locally

After cloning the repo, run npm install, which load dependencies and trigger npm run build.

You may want to build the Javascript part with source map: npm run build:js:debug

Create components

Please refer to Create Silex components

Create templates

Please refer to Create templates for Silex

Contribute code to the core

Let's discuss it beforehand in an issue please, we will definitely help you.

Other projects which need your help!

These are the projects used in Silex and maintained by the same team:

• unifile, a nodejs library which provides a unified access to cloud services
• Cloud explorer, a file manager for the cloud services. It is a front end javascript app which connects to a unifile server
• Stage, a stage component to add a drag and drop to your project
• Prodotype, Build components and generate a UI to make them editable in your app
• Resonsize, preview websites at different sizes

CloudExplorer, unifile and Prodotype are separate projects maintained by the same team. Force Silex to use your local local clones of these projects, use npm link:

$ cd path/to/CloudExplorer/
$ npm link
$ cd path/to/Silex/
$ npm link CloudExplorer

Responsize is another project used by Silex and maintained by us. It is hosted on its own server and acts like a third-party service. When you will do a pull request and it gets merged, it will deploy on the server.

The 3 APIs of Silex

1- Front end API

You can read more about the front end API and how to add features to a website created with Silex with Javascript.

2- Editor's API

Please ask questions about that in the issues and add the answers you get here.

3- Back-end API

Usually you will want to customize Silex backend in order to add "cloud services" or "unifile services" which give your users the ability to read/write their site and assets from/to your servers. Or you may want your users to publish to your servers. Please read more about this in the page Silex for hosting providers.

Submit your code

Issue to discuss the feature and implementation

Please create an issue when you start working and let us a chance to discuss it before hand

Tests

You need to manually test the behavior of your feature and its effect on the user's website

• In the editor
• Outside the editor in preview
• In the final published website

Pull request

Documentation