Setup guide
Pascal CAD guide
Install and use the 3D building editor on Windows or Mac with Bun and a local browser session. Pascal Editor is a web app, not a desktop installer. You install Bun, clone the repository,
Pascal Editor
Install and use the 3D building editor on Windows or Mac with Bun and a local browser session. Pascal Editor is a web app, not a desktop installer. You install Bun, clone the repository, install dependencies, start the local dev server, and open the app in your browser at http://localhost:3000.
What You Need
Windows: Windows 10 version 1809 or later for Bun. Mac: macOS 13 or later for Bun. Both: Git, a terminal, and a browser. Recommended: Bun 1.3 or newer, because that is the setup documented in the repo.
Install Bun on Mac
STEP 1
Install Bun
Open Terminal and run the official install script.
curl -fsSL https://bun.com/install | bash
If needed, reload your shell so bun is on your path, then check
bun –version
STEP 2
Get the repository Clone the project and move into the folder.
git clone https://github.com/pascalorg/editor.git
cd editor
Install Bun on Windows
STEP 1
Install Bun
Open PowerShell and run the official install command. powershell -c "irm bun.sh/install.ps1|iex"
Then verify the install
bun –version
STEP 2
Get the repository Clone the project and move into the folder.
git clone https://github.com/pascalorg/editor.git
cd editor
If Windows says bun is not recognized, restart the terminal and try again.
Install and Run
STEP 3
Install dependencies Run this from the repository root on both Windows and Mac. bun install
STEP 4
Start the editor Run the development server. bun dev The repo documents the app at http://localhost:3000.
STEP 5
Open it in your browser
Use Chrome, Edge, or Safari and visit
http://localhost:3000
How To Use It
Core tools Select for choosing and moving objects. Wall for drawing walls. Zone for creating zones. Item for placing furniture and fixtures. Slab for creating floor slabs.
STEP 6
Build a simple scene
- Pick a level or create one.
- Use the wall tool to draw the room shape.
- Add slabs, zones, and items.
- Switch to Select mode to inspect or move objects.
STEP 7
Use undo and saved state The editor uses local state with undo and redo support. If you make a bad change, undo it from the app rather than rebuilding the scene.
STEP 8
Optional environment file
You do not need environment variables for the editor to work. Copy .env.example to .env only if you want address search. cp .env.example .env
Useful Commands
bun install bun dev bun build bun check bun check:fix bun check-types
Source links: https://github.com/pascalorg/editor,
https://github.com/pascalorg/editor/blob/main/SETUP.md, https://bun.sh/docs/installation.
Final checklist
- The required app, command, or service opens correctly.
- Credentials are stored outside public files and screenshots.
- A small test run completes before you use the setup for real work.
- You know where logs, output files, and error messages are stored.