You are welcome to go through our tutorials but please keep in mind that as we rely on community PRs for maintainance they may be out of date.

Setting up your computer for codebar

You will have a great time at codebar no matter what kind of laptop you have, but you may need to do a little setup before completing the tutorials. You may want to do this at home, so that during a workshop you can jump straight into following the tutorial with your coach. Don’t worry if you have trouble - your coach can help you with this if you prefer.

Somewhere to save your files (required)

Programming projects are normally made up of several related files, and we hope you’ll come back to codebar several times! You should create a folder on your hard drive dedicated to codebar. Create a new folder inside it when you start work on a new tutorial.

A text editor (required)

Programmers use text editors to write code. You could use Notepad (Windows) or (Mac) to write code. However most programmers use a text editor with programming-specific features:

  • Syntax highlighting shows your code in different colours. This helps you spot any errors, and understand the structure of your code.
  • Auto-indent helps you keep your code tidy.
  • Project navigation and tabs helps you move between the different files in your project.
  • Auto-completion shows you keywords you could use to finish what you’re typing, so you don’t have to remember all the possible commands.

We recommend you use Atom or Visual Studio Code at codebar. Both are free, open source, and run on Windows, Mac, and Linux. Sublime Text 3 is another popular choice. It’s free to download and use for as long as you like (though it will nag you intermittently to buy it when you save your work), and it runs on Windows, Mac and Linux.

A web browser (required)

Windows comes with Internet Explorer, and OS X comes with Safari. Most Linux distributions come with Firefox, which is also available for Windows and OS X. You can also download Chrome which is a popular alternative. You can get started with whatever you currently use, but when you reach the later tutorials the powerful developer tools in Chrome and Firefox will be useful. Your coach will show you how to use them while you work through the tutorials.

A compression utility (handy on Windows)

Many of the tutorials have links to download code from Gist in .tar.gz format. Macs and most Linux distributions have built-in support to extract the files from these archives for you. On Windows there are a variety of utilities available. If you don’t already have one, 7-zip is free.

Ruby (optional)

You won’t need Ruby installed if you’re working on CSS or HTML, but you will need access to Ruby if you work on the Ruby tutorials. You can use a free web service called Cloud9 to get started. You can sign up before the workshop to save some time.

If you have a Mac you’ll have a version of Ruby installed already. A coach can help you get started with Ruby on your Mac - ask them about rbenv (or rvm) and Homebrew.

You can download and run the RubyInstaller program to program Ruby on Windows.

On Linux, you can install Ruby using your distribution’s package manager, as follows:

Debian GNU/Linux and Ubuntu use the apt package manager:

$ sudo apt-get install ruby-full

CentOS, Fedora, and RHEL use the yum package manager:

$ sudo yum install ruby

Gentoo uses the portage package manager:

$ sudo emerge dev-lang/ruby

Arch Linux uses a package manager named pacman. To get Ruby, just do this:

$ sudo pacman -S ruby

Python (optional)

For Mac and Linux users, Python usually comes with your operating system. Your coach will show you how to use it to run execute Python code.

For Windows users, Python will need to be installed. Your coach will show you how to install this.