Quickstart For Learners

The following is a more detailed explanation on how to open LearnPack's tutorials locally or in the cloud:

Pick your first tutorial

You can learn many things with LearnPack: What do you want to learn? Our most popular tutorials help you learn javascript arrays, react js, how to build API's with Python Flask, etc.

🛟 Here is a curated list of our recommended tutorials.

Each tutorial is a separate GitHub repository. Go to the GitHub repository website and read the README file to understand what the tutorial is about, you may find an exercises or .learn/exercises` with all the steps and instructions you will be given through the tutorial. We also have this curate list of tutorials from 4Geeks Academy with a UI/UX that makes it a lot easier to pick.

Run the tutorial

The easiest way to run a LearnPack tutorial is to initiate it using our click-and-learn bridge, if you will like to do it yourself (without any magic) read the following guide:

How to open any LearnPack tutorial in the cloud

🛟 Skip this section if you want to run locally on your computer

We picked the Looping with Javascript tutorial for this explanation.

Opening on Github Codespaces

1. Open in Codespaces by clicking the repository Code button and then Create codespace on master
2. When the Codespace finishes loading, it's ready!
3. Now you just have to start reading the instructions and doing the exercises.

Opening on Gitpod

1. Type the following URL on your browser:

https://gitpod.io/#<tutorial repository url>

Please note that <tutorial repository url> needs to be replaced with the github repository URL of the tutorial you want to open, for example:

https://gitpod.io/#https://github.com/4GeeksAcademy/javascript-arrays-exercises-tutorial

🛟 Alternatively You can use the Gitpod expension that makes the process very similar to Codespaces by adding a button like this into the repository website.

How to download and run LearnPack tutorial in your local computer

To use LearnPack locally, you must install Node v20 (or more) and you may also have to install other things depending on the particular tutorial needs.

🛟 We recommend to install Node using NVM, here is a guide on how to install NVM on your computer.

1. Once Node.js is installed, the next step is to install LearnPack using npm:

1npm i -g @learnpack/learnpack

1. Clone a LearnPack repository

Open the terminal and run the git clone command with your repository URL. For example, with the Javascript tutorial:

1git clone https://github.com/4GeeksAcademy/javascript-arrays-exercises-tutorial.git

1. Enter the new recently created directory

A directory with the name of the tutorial will be created; enter it with the cd command:

1cd javascript-arrays-exercises-tutorial

1. Start executing LearnPack

When you installed LearnPack globally, a new option was added to your computer's commands, now you can execute:

1learnpack start

In the directory of a LearnPack tutorial, and you're done.

Note: If LearnPack detects that not installed plugins are needed for your tutorial, LearnPack will install them. Then just restart with learnpack start

Use LearnPack locally with VSCode

Also, if you have VSCode on your computer, install the Learnpack extension. Once you are inside a LearnPack tutorial in VSCode, if it is the first time you start, the LearnPack extension will execute learnpack start for you.