Getting started

Quickly set up a Dip development environment and write your first app!

Installing Dip

You can try Dip online in your browser without installing it on your computer.

Try Dip without installing

Install Dip

The primary way that folks install Dip is through downloading a zip file containing the Dip interpreter, Dip Editor and Dip's standard library.

If you’re running macOS, Linux, or another Unix-like OS, download the Mac version of Dip. If you are on Windows, download Dip's Windows version

If you're a Mac or Unix fan - here's Dip's Version R for Mac! It also includes Dip's standard library

Download Dip for Mac

If you're a windows fan - here's Dip's Version R for Windows! It also includes Dip's standard library

Download Dip for Windows

How Do I Get Started?

Move the Dip Version R (Mac) zip file to your desktop - and extract the contents of the zip file. Then navigate to the Dip Version R folder, and start creating Dip programs!

On Windows, all you need to do is unzip the file and navigate to the Dip Version R folder. Run the executables to start coding with dip

How Do I Use Dip?

There are two ways to use Dip at the moment. One of them is to use Dip's Editor, which is beginner friendly and is a built-in code editor for you to start using Dip. However, it is still experimental and might have some bugs.

The second way you can use dip is through the executable file called 'Dip'. The Dip interface pops up in the terminal of your choice when you click it - and you can start using Dip! This has more, robust features when compared to the Dip editor, but might not be very easy to use for beginners.

Whichever way you choose to use Dip, you can always look at the documentation to help you, which you can find on the website, and also in the Dip folder you download.


Learn more about installation

Dip's Development Environment

When you install Dip you’ll also get the latest version of the Dip Editor, also known as Dip's Development Environment. Please note that the Editor is experimental, and might hav some bugs in its control flow. However, it still does a lot of things:

  • Create and edit Dip programs with Dip's Editor.
  • Use the shell to run commands using a user-friendly interface
  • Test your project and run it through Dip's Editor (Nothing else required)
  • Build documentation for your project through Dip's editor

In essence - Dip's Development Environment is a one stop shop providing everything you need to write meaningful software using Dip


If you're a Mac or Unix fan - here's Dip's editor for Mac! It also includes examples

Download for Mac

If you're a windows fan - here's Dip's editor for Windows! It also includes examples!

Download for Windows

Adding dependencies

Let’s add a dependency to our application. Navigate to the Dip Version R folder, and create a "hello.dip" file. It is better to create all of your dip programs here, as you can easily access Dip's standard library from this directory.

In this project, we’ll use a package called bleu_says Note that the bleu_says package comes prepackaged with dip in its standard library.

In our hello.dip file we’ll add this information (that we will use for installing any packages):

use("stdlib/bleu_says")

This line means that we can now use the bleu function that the blue_says package creates for us.

Now we can use the blue_says package to create our first dip application

Look at the learning path!

Before you get started you're looking to learn more, head to the learning path, and see how you can learn to code in Dip the easy way.

Take me to the learning path!

A small Dip application

Now let’s write a small application with our new dependency. In our main.dip, add the following code:

use("stdlib/bleu_says.dip") # from the previous step

function main()
    variable message = "Hello, world!"
    bleu(message)
end

main()
    

Once we save that, we can run our application by typing:

run("main.dip")

Assuming everything went well, you should see your application print this to the screen:

-----------------
| Hello, world! |
-----------------
                    \
                     \
                      \
                           ▓▓▓▓▓▓▓▓▓▓
                         ▓▓▓▓▓▓▓▓▓▓▓▓▓▓
                        ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
                      ▓▓▓▓░░░░░░▓▓░░░░░░▓▓▓▓
                  ░░░░▓▓░░░░░░░░░░░░░░░░░░▓▓░░░░
                  ░░░░▓▓░░  ██░░░░░░  ██░░▓▓░░░░
                    ░░▓▓░░████░░░░░░████░░▓▓░░
                      ▓▓░░▒▒▒▒░░░░░░▒▒▒▒░░▓▓
                        ▓▓░░░░░░░░░░░░░░▓▓
                          ▓▓▓▓░░░░░░▓▓▓▓
                              ▓▓▓▓▓▓        ░░
                            ▓▓▓▓▓▓▓▓▓▓      ▓▓
                            ▓▓▓▓▓▓▓▓▓▓    ▓▓▓▓
                          ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
                          ▓▓▓▓░░▓▓░░▓▓▓▓

    

Learn more!

If you're looking to learn more, head to our Docs page, where you can find lots of information that will help you to continue learning to code with Dip.

learn more!