Skip to content

Latest commit

 

History

History
130 lines (82 loc) · 4.28 KB

setting_up_a_devcontainer.md

File metadata and controls

130 lines (82 loc) · 4.28 KB

Devcontainer Setup

Step-by-step tutorial on how to set up a stdlib development environment in a dev container.

Introduction

We appreciate your interest in contributing to stdlib! Below, we've provided a step-by-step tutorial on how to set up the project locally on your device using a dev container.

Dev containers, are Docker containers that are specifically configured to provide a fully featured development environment with the right tooling, extensions, linting and formatting. They allow you to open any folder inside (or mounted into) a container and take advantage of Visual Studio Code's full feature set.

The stdlib repository includes a preconfigured dev container, making it the easiest way to set up your development environment. It ensures proper linting, EditorConfig, and tooling are configured right from the start.

Note: The dev container does not yet support ARM64 architectures. For more information, or if you're interested in adding ARM64 support, you can visit this issue.

Prerequisites

Setting up the stdlib dev container requires the following prerequisites:

Download

To acquire the source code, first navigate to the parent directory where you want to place the project's Git repository.

$ cd /path/to/parent/destination/directory

Next, clone the repository.

$ git clone https://github.com/stdlib-js/stdlib.git

If you are wanting to contribute to stdlib, first fork the repository and amend the previous command.

$ git clone https://github.com/<username>/stdlib.git

Open the repository in VS Code.

$ cd stdlib && code .

When prompted, open the repository in the dev container.

Prompt by VS Code to reopen the repository in a devcontainer.

Please be patient, as the post-create script may take some time to install all the required languages and dependencies.

Start of the post-create script in a terminal.

Close the terminal and wait for other dependencies to install.

Prompt to close the terminal and wait for other dependencies to install.
Terminal window showing the progress of downloading Electron while configuring a Dev Container.

Close the terminal after the installation is completed.

Terminal window showing completion of the post-create script and prompting the user to close it.

If you see this when you open the terminal, then the dev container installation was successful!

Terminal window with a welcome message by GitHub Codespaces after it was successfully installed.