Alchemical Canvases with tldraw SDK
The Terminal Altar
The Creative Workspace
Every digital project begins in a workspace. While you might be used to graphical interfaces with windows and icons, there’s a more direct, powerful space available: the Terminal. Think of it not as a tool just for programmers, but as a clean, quiet room where you can give your computer precise instructions to build, create, and manage your work.
Instead of clicking on folders, you'll type commands. This might feel strange at first, but it offers incredible speed and control. Let's open our workspace.
Press Command (⌘) + Spacebar to open Spotlight Search. Type "Terminal" and press Enter. A new window with a blinking cursor will appear. This is your command line.
Navigating Your Digital Space
Your computer organizes everything in a system of nested folders, technically called directories. When you open the Terminal, you start in your home . To get your bearings, you can ask two simple questions: "Where am I?" and "What's around me?"
To ask "Where am I?", use the pwd command, which stands for "print working directory."
pwd
Press Enter, and the Terminal will show you the exact path to your current location, like /Users/yourusername.
To ask "What's around me?", use the ls command, which stands for "list."
ls
This command lists all the files and folders in your current directory. You'll likely see familiar folders like Desktop, Documents, and Downloads.
To move from one directory to another, you use the cd command, for "change directory." Let's move to your Desktop. Type cd Desktop and press Enter.
cd Desktop
Your prompt might change to show you're now in the Desktop folder. If you type pwd again, you'll see the path has been updated. To go back up one level, you can use cd ...
Preparing the Foundation
To build modern digital projects, we need a special engine to run our code. For our purposes, that engine is . It's a runtime environment that lets us use JavaScript—the language of the web—to build applications right on our computer. Think of it as the power source for our workshop.
Along with Node.js comes npm, which stands for Node Package Manager. If Node.js is the power source, npm is the tool that lets you easily install new tools and parts (called packages) for your projects. It's like having a catalog of pre-built components you can add to your creations.
Let's check if you have these tools installed. In your Terminal, type the following commands, pressing Enter after each one.
# Check for Node.js
node -v
# Check for npm
npm -v
If they're installed, the Terminal will report their version numbers (e.g., v18.17.1). If you get an error like command not found, you'll need to install them first. Don't worry, it's a standard part of setting up any developer's machine.
This setup—your computer, the Terminal, Node.js, and npm—forms your local development environment. It's a self-contained space on your machine where you can build and test projects before sharing them with the world.
With our workspace open and our tools verified, we're ready to start building.