# Run EduBASIC locally

This folder is a copy of the EduBASIC web application. EduBASIC must be served over HTTP (for example `http://localhost:3000`). Opening `index.html` directly in the browser will not work.

## What you need

- **Node.js** (LTS recommended), which includes **npm**
- A modern browser (Chrome or Edge recommended)

### Install Node.js on macOS

1. Download the **LTS** installer from [https://nodejs.org](https://nodejs.org).
2. Run the installer and follow the prompts.
3. Open **Terminal** and verify:

```bash
node --version
npm --version
```

Alternatively, if you use Homebrew:

```bash
brew install node
```

### Install Node.js on Windows

1. Download the **LTS** installer from [https://nodejs.org](https://nodejs.org).
2. Run the installer. Leave **Add to PATH** enabled.
3. Open **Command Prompt** or **PowerShell** and verify:

```bat
node --version
npm --version
```

## Run EduBASIC

1. Unzip this archive if you have not already.
2. Open a terminal in this folder (the folder that contains `index.html`).
3. Start a local static server:

```bash
npx serve
```

The first run may download the `serve` package; that is normal.

4. Open the URL shown in the terminal (usually `http://localhost:3000` or `http://localhost:5000`) in your browser.
5. When you are finished, return to the terminal and press **Ctrl+C** to stop the server.

## Lab deployment

Copy this entire folder to each computer in the lab. Node.js only needs to be installed once per machine. Teachers or students run `npx serve` from the folder when they want to use EduBASIC.

## Online version

When internet access is available, you can use EduBASIC at [https://www.edubasic.net](https://www.edubasic.net) with no local setup.

## License

This folder contains the **EduBASIC web application**, licensed under the [MIT License](LICENSE) (Copyright © 2025 Dietz-Moss Publishing).

The EduBASIC User Guide PDF (when downloaded separately from the website) is a copyrighted book and is not open source.
