Skip to content
DESDR

Sliders Installation Guide

Quick Summary

What You Need

  • A computer with MacOS or windows
  • Basic familiarity with the Terminal app

Step 1: Software Requirements Specification

Install Node.js and NPM Manually

  • Get Node.js: Go to Node.js Downloads and choose the installer for MacOS. Follow the prompts to install.
  • Check Installation: Open Terminal and type node -v and npm -v. If you see version numbers (like v18.0.1), you’re set! If not, the installation might need a do-over.

Alternate: Install Node.js and NPM using Terminal on MacOS (untested)

  1. Get Node.js

    Terminal window
    sudo apt update
    sudo apt install nodejs
    sudo apt install npm

  2. Check Installation

    Terminal window
    node -v
    npm -v

Step 2: Get the Project Files

Choose one of the following methods based on your access and preference:

Option A: GitHub (if you have access)

Mac OS

  1. Visit the [svelte-pi GitHub page].

  2. Use the green “Code” button to find the SSH option and copy the link provided, i.e. git@github.com:Columbia-DESDR/svelte-pi.git.

  3. In Terminal (on MacOS) or Command Prompt (on Windows), navigate to where you want the project. E.g.:

    Terminal window
    cd ~/Desktop
    mkdir sliders
    cd sliders

  4. Clone the repo:

    Terminal window
    git clone git@github.com:Columbia-DESDR/svelte-pi.git

  5. Optional: Switch branches with git checkout [branch-name] if needed.

Option B: Zipped File (no GitHub access)

  1. Go to the DESDR team’s Google Drive and download temp_install.zip.
  2. Unzip it wherever you prefer.

Step 3: Launch Your Website

  1. Open Terminal and navigate to the project folder. E.g. cd ~/Desktop/sliders/svelte-pi or wherever you placed it.

  2. Install dependencies:

    Terminal window
    npm install

  3. Start the site:

    Terminal window
    npm run dev

  4. Terminal will give you a local URL (like http://localhost:xxxx/). Paste it in your browser to see your site live!