preview

Starts the Buildertrend dev server and opens the frontend in a browser.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/buildertrend/product-toolkit --skill preview-buildertrend
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preview
Source: https://github.com/buildertrend/product-toolkit/tree/main/frontend-setup/skills/preview
Command: npx skills add https://github.com/buildertrend/product-toolkit --skill preview-buildertrend

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-engineering team members who have completed the initial setup need a guided way to launch the local Buildertrend frontend without memorizing terminal commands, Node version requirements, or hosts file configuration. ## Core Features & Use Cases - Environment Verification: Locates the BTNet repository, checks Node and pnpm versions, and creates the missing .env.development.local file when needed. - Hosts File Configuration: Walks Mac and Windows users through adding the local.buildertrend.net entry to their system hosts file. - Server Launch & Preview: Detects whether port 443 is already in use, starts the dev server with pnpm run start, and directs the user to https://local.buildertrend.net:443/. - Use Case: A product manager wants to preview UI changes before a review meeting. They ask Claude to start the app, and the Skill verifies prerequisites, starts the server, and confirms the Buildertrend UI loads in the browser. ## Quick Start Ask Claude to start the Buildertrend app and open it in your browser so you can preview your changes.

Frequently Asked Questions about preview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start the Buildertrend frontend locally?

Run the preview command after completing the first-time setup. The Skill locates the BTNet repository, verifies Node and pnpm versions, starts the dev server with pnpm run start, and opens https://local.buildertrend.net:443/ in your browser.

How do I preview UI changes in Buildertrend without engineering help?

Ask Claude to start the app or run the preview command. It handles prerequisite checks, hosts file configuration, and server startup automatically, explaining each step in plain language for non-technical users.

Does the preview work on both Mac and Windows?

Yes, the Skill detects your operating system automatically and adjusts commands accordingly. On Mac it uses sudo pnpm run start and lsof for port checks; on Windows it uses pnpm run start and netstat.

Why does the browser show a blank page after starting the dev server?

The dev server may still be starting up, so wait for the ready message in the terminal. If errors persist, check for missing dependencies and reinstall them with pnpm install from the BTNet root directory.

What should I do if port 443 is already in use?

If a server is already running on port 443, the Skill skips startup and opens the browser directly. If another process occupies the port, run lsof -i :443 on Mac to identify it and stop that process first.