Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
72 lines (49 sloc) 2.33 KB

Frontend

Caution!

This documentation is WIP.

The Javascript code in Cuckoo web is developed in ECMASript 6. For browser compatibility, this will need to be transpiled back to ECMAScript 5.

Cuckoo makes use of Gulp to build from source to static (frontend sources). Before you can use this, make sure that the following dependencies are installed (required for Node and following assets):

On a Debian based system the package requirements are:

After these packages have been installed, navigate to the source folder (cd cuckoo/web/src) and run npm install. This will install all node modules as listed in package.json. After this you should be good to go!

NPM Executables

While in the cuckoo/web/src directory (or the directory where package.json is located) you can run the following commands:

gulp OR npm start
runs build processes and starts watcher
gulp build OR npm run-script build
build source to static ONCE.
gulp styles
only runs the 'styles' task (compiles SCSS to static/css)

Transpiling/Compiling

Try modifying one of the .js files in the cuckoo/web/src/scripts/ directory and confirm that Pycharm transpiles the Javascript to ECMAScript 5.

Creating new tasks

You can easily plug in new tasks by creating a new javascript file in cuckoo/web/src/tasks. Gulpfile.js automagically loads these tasks and will be available throughout the npm session gulp uses (this means you don't have to do a lot more.).

A gulp module in its basic form looks like this:

- coming!