Before You Start Reading:
If you’re a beginner in Sass, this detailed tutorial is for you. I really hope you enjoy it, I spent a few days working on it to create a compelling and useful message.
Please recommend it at the end if you found it useful 😊 — Thanks!
By the way, this article can also be downloaded in PDF, look for the link at the bottom.
What makes this guide different?
I remember almost 2 years ago (today being 5/8/2014) I looked all over the web for a simple guide, with simple steps, in “human” language to help me install Sass. There was NOTHING. Well, actually there was this one website (I can’t even find it now anymore) that had a very, very rough list of how to do it, but yet it was the ‘friendliest’ of everything else I came across.
After trying to install Sass three times in a span of about 3-4 months, I was finally able to “crack the code”. Now, here I am showing you how to do it 😉.
So what makes this guide different from aaaaalll other guides out there? It’s different because I’m going to explain it to you the way I would’ve liked to have seen it explained to me back then, when I had no clue about command line crap (and I still don’t to be honest).
This is a:
A. Simple Guide
B. With simple Steps
C. In human language
Here we go 🚀!
Steps to Installing Sass on Windows (versions 7/8/10)
1. Download the Ruby installer: http://rubyinstaller.org/downloads/ — Look for the version with (x64) on it.
Edit (12/8/2016) — I’ve confirmed that Sass works fine with Ruby 2.3.3 (x64) at the moment of this edit.
̶E̶d̶i̶t̶ ̶(̶4̶/̶1̶4̶/̶2̶0̶1̶5̶)̶ ̶ — ̶ ̶M̶a̶k̶e̶ ̶s̶u̶r̶e̶ ̶t̶h̶e̶ ̶R̶u̶b̶y̶ ̶i̶n̶s̶t̶a̶l̶l̶e̶r̶ ̶i̶s̶ ̶v̶e̶r̶s̶i̶o̶n̶ ̶1̶.̶9̶x̶.̶ ̶I̶t̶’̶s̶ ̶b̶e̶e̶n̶ ̶m̶y̶ ̶e̶x̶p̶e̶r̶i̶e̶n̶c̶e̶ ̶t̶h̶a̶t̶ ̶u̶s̶i̶n̶g̶ ̶a̶n̶y̶ ̶o̶f̶ ̶t̶h̶e̶ ̶2̶.̶x̶ ̶v̶e̶r̶s̶i̶o̶n̶s̶,̶ ̶S̶a̶s̶s̶ ̶d̶o̶e̶s̶n̶’̶t̶ ̶w̶o̶r̶k̶.̶ ̶I̶f̶ ̶a̶n̶y̶o̶n̶e̶ ̶c̶a̶n̶ ̶c̶o̶n̶f̶i̶r̶m̶ ̶o̶t̶h̶e̶r̶w̶i̶s̶e̶,̶ ̶p̶l̶e̶a̶s̶e̶ ̶l̶e̶t̶ ̶m̶e̶ ̶k̶n̶o̶w̶ ̶i̶n̶ ̶t̶h̶e̶ ̶c̶o̶m̶m̶e̶n̶t̶s̶.̶ ̶T̶h̶a̶n̶k̶s̶.̶
WTF is Ruby? 😕
Ruby is the technology or programming language Sass is built on. So you need to install Ruby first so Sass can then run on top of it. 😌
2. Open the Command Line (CMD)
Tip!: Press Windows Key + R and type: CMD, then press Enter.
The almighty Command Line (CMD) will appear:
3. Type the following command in the CMD (it doesn’t matter which folder you’re in):
gem install sass
WTF is a gem 😕?
A gem is piece of software or app made to run on Ruby. It’s like… installing an addon on Firefox or an extension on Chrome 😌.
It’ll take a few seconds to install Sass. At the end you’ll see this (the Sass version may very well be different now though):
Successfully installed sass-3.3.7
1 gem installed
Installing ri documentation for sass-3.3.7…
Installing RDoc documentation for sass-3.3.7…
Here’s a screenshot of what you’ll see in the CMD:
That’s it! Sass is now installed on your machine 🎉!
Yeah, I know it looks “doh!” and simple but believe me, there were no screenshots of anything back then and most of the installation tutorials were for Macs.
So hopefully someone can find these steps useful and clear as they need to be.
Check the “PATH” if you’re having issues executing Ruby
Sometimes, for some unknown reason, Ruby doesn’t get properly installed in your PATH. If this happens to you, check your PATH to make sure the folder to Ruby is listed there.
Don’t know what the PATH is? No problem, read this post I created exactly for this moment 😉: The effin’ PATH demystified (Windows).
…Or Reinstall Ruby
If you don’t know how to edit the PATH, relax. Just reinstall Ruby and make sure you have the ‘Add Ruby executables to your PATH’ option checked:
Steps to use Sass
Ok, what I’m about to show you is COMPLETELY different than what any other Sass tutorial out there tells you to do.
Why? Because most of those tutorials complicate things too much.
1. Create a /Demo folder anywhere on your drive
2. Inside that folder create two sub folders: /css and /scss
3. Create a .scss file
Go into the /scss folder and create a file called: demo-styles.scss
Notice the file extension .scss? This is your Sass file 😊. And yes, right now there’s nothing in it, it’s empty.
4. Go back to the CMD line for a minute
In the CMD line you need to go to the /Demo folder.
Tip!: The easiest way to go the /Demo folder is by dragging & dropping from your file manager into the CMD window, like this:
I. In the CMD type: cd(space), yes, a space after “cd”.
“cd” means Change Directory.
II. From your file manager drag & drop the /Demo folder into the CMD window.
III. Press Enter
IV. You should be in the /Demo folder now
Note: In my animated GIF above I used my Z: drive to create the /Demo folder, that’s why you see an extra step where I have to type ‘z: + Enter’ in order to go to that drive.
And, here come the cool parts:
Make Sass watch your SCSS files and make it compile the CSS
5. Make Sass “watch” your /scss and /css folders
Type this in the CMD:
sass --watch scss:css
That’s it. You are now using Sass 😁!
WTF is the “--watch” command 😕?
Actually, the “--watch” command is not a “command”. It’s called a flag.
The “--watch” flag tells Sass to “pay attention” to the folders /scss and /css, so when you make changes to the .scss file (demo-styles.scss) Sass will detect the change and compile the SCSS file into the final CSS file you’re going to use on your website or app 👍.
All tutorials I’ve read make you watch specific files, like this:
sass --watch styles.scss:styles.css
…which is Ok. I just think that watching folders is easier and makes more sense because you’re watching ALL FILES in both directories rather than specific ones, and saves you having to type too much in the CMD as well.
6. Edit the .scss file and watch Sass compile it into a .css file
I. Open your CSS editor (I use Sublime Text)
II. Open the file demo-styles.scss
III. Add some CSS to it
IV. Save the demo-styles.scss file
V. Verify in your CMD that the compiling was successful
VI. Open your demo-styles.css and enjoy your new creation
You now have leveled up by knowing how to use Sass☺.
Note: As you can see I’m writing basic CSS, not Sass because what I’m trying to show you here is how the .css file is compiled.
Yeah, post a little longer than others but I think the clarity in the steps makes it worth it.
If you’re interested in another ‘simple & friendly’ post about the pure basics of Sass, drop me a message.
Thanks for reading 😎!
If you found this post valuable, don’t forget to Recommend it below :). Thanks!