Skip to content

Latest commit

 

History

History
146 lines (94 loc) · 3.97 KB

activity0.md

File metadata and controls

146 lines (94 loc) · 3.97 KB
Raw

Workshop Activity 0: Installing Prerequisites

Before starting the workshop, make sure you have all the necessary software installed. This guide will help you set up the required tools on both macOS and Windows.

Prerequisites

  1. Docker Desktop
  2. Code Editor (VS Code recommended)
  3. Administrator Access (to update the hosts file)

Optional

This project uses TailwindCSS to the visual design. If you wish to modify the UI then you may need;

  1. Node.js (to run npx)
  2. TailwindCSS CLI

Note:

You will need administrator access on your machine to update the hosts file.

1. Docker Desktop

Docker Desktop is required to run the workshop environment using containers.

macOS Installation:

  1. Download Docker Desktop from the Docker website.
  2. Open the .dmg file and drag Docker to your Applications folder.
  3. Launch Docker from your Applications folder.
  4. Follow the instructions to complete the installation.

Windows Installation:

  1. Download Docker Desktop from the Docker website.
  2. Run the installer and follow the prompts.
  3. Restart your computer if prompted.

Verify Installation:

To check if Docker is installed correctly, open a terminal (macOS) or PowerShell (Windows) and run:

docker --version

2. Code Editor

Bring your favorite code editor to the workshop. We recommend using Visual Studio Code (VS Code) for the best experience.

Download VS Code:

VS Code supports extensions for both Python and Node.js development, making it a versatile editor for this workshop.

3. Administrator Access to Update Hosts File

You will need administrator access to modify the hosts file on your machine. This is necessary to map the workshop domains (platform.ltitraining.net and tool.ltitraining.net) to your local environment.

  • On macOS: You can modify the hosts file by opening the terminal and running:
sudo nano /etc/hosts
  • On Windows: You will need to open Notepad as an administrator and edit the file located at:
C:\Windows\System32\drivers\etc\hosts

Make sure to add the following lines to the hosts file:

127.0.0.1 platform.ltitraining.net
127.0.0.1 tool.ltitraining.net

On some versions of MacOS the change may not be immediate. You can flush the dns to force the change to take place;

sudo killall -HUP mDNSResponder

If the above files are installed, You should be all set for the workshop.

Optional Dependencies

The following steps are not necessary for the workshop, but they might be useful in development if you want to change the CSS in the example projects;

1. Node.js (with npx)

Node.js is required to run JavaScript-based tools like npx.

macOS & Windows Installation:

  1. Download Node.js (LTS version) from nodejs.org.
  2. Install it by following the prompts.

Verify Installation:

To check if Node.js and npx are installed correctly, run:

node --version
npx --version

2. TailwindCSS CLI

TailwindCSS is a utility-first CSS framework which some of the samples use. You may need its CLI for the workshop..

macOS & Windows Installation:

  1. Open your terminal (macOS) or PowerShell (Windows).
  2. Install the TailwindCSS CLI globally using npm:
npm install -g tailwindcss

Verify Installation:

To check if TailwindCSS is installed correctly, run:

tailwindcss --version

Summary

Ensure that the following tools are installed:

  • Docker Desktop
  • A code editor (VS Code recommended)
  • Administrator access to modify the hosts file

Optional:

  • TailwindCSS CLI
  • Node.js (with npx)

Once everything is installed, you’re ready to proceed to the next activity where we’ll set up the Docker environment.