proxy

A proxy for school — runs the Interstellar unblocker in GitHub Codespaces.

Run Interstellar in a Codespace

1. Click the green "Code" button on this repository.
2. Select "Codespaces" and create a new codespace.
3. In the Codespace terminal, run the following commands:

# clone the Interstellar unblocker repository
git clone https://github.com/UseInterstellar/Interstellar.git
cd Interstellar

# install dependencies (pnpm is used by the project)
# If pnpm is not available in the Codespace, install it first: npm i -g pnpm
pnpm install

# start the development server
pnpm start

4. After pnpm start the server will print which port it is listening on (common ports are 3000 or 5173). In the Codespaces UI open the "Ports" panel (bottom or the left-hand sidebar). Locate the port that the app reported and click the globe icon or "Make public" to expose it.

5. Click the forwarded port link in the Ports panel to open the running Interstellar unblocker in your browser.

Tips and troubleshooting

• If you want to force a port (for example 3000), set the PORT environment variable before starting, for example:

# POSIX shells
PORT=3000 pnpm start

# Windows PowerShell
$env:PORT = 3000; pnpm start

• If the Interstellar repo uses a specific start script or framework (Vite, Next.js, etc.), you may be able to pass a port flag instead (for example pnpm start -- --port 3000 or pnpm run dev -- --port 3000). Check the Interstellar README if pnpm start does not accept a port flag.
• If pnpm is not installed in the Codespace, run npm i -g pnpm before pnpm install.