Build a JavaScript Compressor tool using NodeJS, ExpressJS, Jade, UglifyJS tutorial

Document version number: initial post

As the title states its a beginners tutorial with a lot of stuff to learn.

This tutorial exist to give you a little bit of understanding on how things like NodeJS, ExpressJS, bootstrap, jQuery and Jade template engine work together.

Web Application

In this tutorial we will be creating a full web application with 2 pages.

  1. Main page where people can compress their Javascript files
  2. About Page which explains a bit about our app

The web application that we are gonna write address a problem about how to use UglifyJS to compress the JavaScript files.

I am going to add more feature to the above app but for this tutorial lets keep things simple.

I hope that you have installed NodeJS on your box. If you haven’t here are instructions to install it on Ubuntu 12 

If you are using Windows you can just download the installer and node will be available from command line.

After your installation npm and node commands will be available to your from command prompt. npm stands for Node Package Manager and it helps install Node Packages.

First up create a folder somewhere on your file system called uglify All our App files will go under this folder.

To start with lets create a package.json file under our parent folder (uglify) with the following contents in it

Above package file is pretty easy to understand. Main part in above file is dependencies bit and we will see in a second how its really easy to install dependencies for you project in one hit

Now we will just run the following command

make sure that you you are in same directory as package.json and then run this command

This will install node modules essential to run our code smoothly.

So node modules that will get installed are Express framework, uglifyJS, Jade template engine

Lets now create couple of more folders in your working directory called public and views and also create a file with name app.js

I’ll explain in a bit what app.js is all about. So here is a screenshot of our folder structure for the time being

NodeJS default folder structure

 

Under public folder I have created three sub folders as shown below

nodejs_folder_structure_public

 

As you can see how I’ve included twitter bootstrap (the CSS framework for responsiveness) under the css folder and then all my public images goes to img folder and likewise all my javascript goes in js folder

Now lets start to work on our app.js file

If you are unaware what expressJS is, then you must read some documentation on Express which can be found here

expressjs in broader terms is a node framework that makes you life easier a bit and save you many lines of code.

ok! lets carry on with our app.js file, app.js defines our application and carry most of the code that deals with user requests.

Here is basic code for our app.js file

Please note that we are not using full MVC in our application, its just views that are separated out. depending on the complexity of your Node App you should be looking for a MVC structure that will help immensely with code maintainability. I won’t recommend that your app.js should go beyond few 10s of lines. We will add one more request handler in our app.js file in a bit

please note that app.listen() tells node which port your application is listening to. In our case its port 8080.

ok! before we can kick of our application we have to look at our view file. So here is a full structure of my views folder for icompressjs.com

node_jade_views

We will be concentrating just on layout.jade, header.jade, footer.jade and index.jade in our example application

Remember! that in our app.js we told node to use jade as our template engine. Know more about jade by browsing official documentation page located here

https://github.com/visionmedia/jade#readme

We have a common layout page that will be applied to all other files as shown below

File layout.jade

All whitespaces are important else your file may not work or produce unexpected results. I will not be explaining about jade how it works but let me share a couple of cool cssdeck’s that explain much of the working of jade

  1. Part 1
  2. Part 2

so as you can see that we are using HTML5 as our doctype with !!! 5 declaration

Please remember “block content” is a reference which will be replaced by actual index.jade contents during processing. Its explained later in this article. Just remember this reference for the time being.

then we are including our header file that have our navigation and other includes that will be common to all sub templates, lets check it out

Before we proceed with our index.jade template lets quickly check whats in our footer.jade file

You can have whatever you like in your footer.

Lets now check out out index.jade view

Couple of things to note above

  1. extends layout is a reference to layout.jade and explicitly telling that in layout.jade look for
  2. block content and put the contents at its place

Other stuff is just normal HTML and a click event handler (jQuery) added at the end for compress it button

 

Alrighty! with all the files in place its time to run our app

run your app as

If there are any issues you will know straight away. the code above is verified so it should work without giving much grief.

Now that if some other process is not already using port 8080 its time to direct your browser to http://127.0.0.1:8080

You should see something like this

node_example

By itself it will not work as yet as we did not add the handler for user click for Compress it button

Go back to your app.js file and put this code before app.listen(8080)

So now when you click on Compress button it should compress your javascript code take from the textarea that user pasted the code into.

The uglifyjs options and method calls is the code take from their official github documentation page that can be found here

ttps://github.com/mishoo/UglifyJS

Thats it you have your javascript compressor website ready with NodeJS

 

 

Download Source

If you would like to have full source code please let me know.

 

 

I hope that this helps

Cheers

Comments

  1. Thanx, I will see if this can be an alternative for compressing by google closure compiler for me.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.