BareMetal-C Builder

A lightweight VS Code extension designed for the CS Freshman C Programming Course.

This extension provides a simple right-click context menu to Build and Clean Z80 BareMetal C projects using our course's Docker toolchain.

⚡ Features

Right-Click Build: No need to remember complex docker run or make commands. Just right-click your project folder.
Automatic Clean: Easily remove .ihx, .rel, and .map files to start fresh.
Batch Operations: Build or Clean all projects in your workspace at once.
Error Matching: Automatically detects SDCC compiler errors and links them directly to the line of code in the editor.

This extension relies on the course Docker image.

Docker Desktop (or Docker Engine on Linux) must be installed and running.
You must have the course docker image pulled (the extension will attempt to run the standard container command).

Open your assignment folder in VS Code.
In the Explorer sidebar, Right-Click on the folder containing your C code.
Select ⚡ BareMetal C ⚡ in the context menu.
Choose an option:
- 🔨 Build Project: Compiles the selected folder.
- 🧹 Clean Project: Removes temporary build files.

Tip: If you have multiple assignments open, you can use Build All to compile everything at once.

"Docker is not running" error:

Make sure the Docker Desktop application is open and the whale icon is visible in your taskbar.

"SDCC not found" or Build Fails:

Ensure you have internet access the first time you run a build so Docker can pull the compiler image.