Skip to main content
Two ways to begin: run in the cloud with GitHub Codespaces or Gitpod, or run locally with Node and the LearnPack CLI. Pick what fits your setup today.

Start learning with LearnPack

The following explains how to open LearnPack tutorials locally or in the cloud, using your existing GitHub repositories.

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, and how to build APIs with Python Flask.
πŸ›Ÿ Here is a curated list of our recommended tutorials.
Each tutorial is a separate GitHub repository. Open the repository and read the README to understand the scope. You may find an exercises folder or a .learn/exercises path with all the steps and instructions you will follow. We also have this curated list of tutorials from 4Geeks Academy with a UI that makes selection easier.

Run the tutorial

The easiest way to start a LearnPack tutorial is our click-and-learn bridge: If you would rather do it yourself, use the guides below.

Open any LearnPack tutorial in the cloud

πŸ›Ÿ Skip this section if you want to run locally on your computer.
We will use the Looping with Javascript tutorial as an example.

Opening on GitHub Codespaces

  1. Open the repository, click Code, then Create codespace on master.
    Create Codespace
  2. Wait for the codespace to load.
  3. Start reading the instructions and complete the exercises.
    Codespace loaded

Opening on Gitpod

  1. Type this URL in your browser:
https://gitpod.io/#<tutorial repository url>
Replace <tutorial repository url> with the tutorial’s GitHub URL, for example:
https://gitpod.io/#https://github.com/4GeeksAcademy/javascript-arrays-exercises-tutorial
πŸ›Ÿ You can also use the Gitpod browser extension to add a one-click button on GitHub.

Download and run a tutorial on your computer

To use LearnPack locally, install Node v20 or newer. Some tutorials may require additional tools.
πŸ›Ÿ We recommend installing Node via NVM. Guide: install NVM on your OS.
1) Install LearnPack globally
npm i -g @learnpack/learnpack
2) Clone a tutorial repository Example with the JavaScript tutorial:
git clone https://github.com/4GeeksAcademy/javascript-arrays-exercises-tutorial.git
3) Enter the directory
cd javascript-arrays-exercises-tutorial
4) Start LearnPack
learnpack start
If LearnPack detects missing plugins for the tutorial, it will install them. Then run learnpack start again. Needed plugins

Use LearnPack locally with VS Code

If you use VS Code, install the extension: LearnPack for VS Code. Once inside a LearnPack tutorial, the extension will run learnpack start for you on first launch.

Choose the best mode

OptionRequirementsBest for
GitHub CodespacesGitHub account with Codespaces enabledZero setup, fastest start
GitpodGitpod accountCloud dev with easy launch from GitHub
Local with CLINode v20+, Git, terminalFull control, offline work
Local with VS CodeVS Code + LearnPack extensionGUI comfort plus local speed
Tip: Start in the cloud to try a tutorial, then move local for longer sessions or offline work. You can switch at any time.

Next up

See also