skills.rest
buildertrend
buildertrendOFFICIAL
Explore all skills by this author →
Website𝕏@buildertrendGitHub

first-time-setup

Guides non-engineers through installing and running the Buildertrend frontend locally.

Updated Mar 24, 2026
Search Tags:#onboarding#pnpm#nodejs#azure devops#environment configuration#frontend setup#git clone
One-click install
npx skills add https://github.com/buildertrend/product-toolkit --skill first-time-setup-buildertrend
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: first-time-setup
Source: https://github.com/buildertrend/product-toolkit/tree/main/frontend-setup/skills/first-time-setup
Command: npx skills add https://github.com/buildertrend/product-toolkit --skill first-time-setup-buildertrend

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designers and PMs without development experience struggle to set up a local frontend environment involving terminals, Git, Node.js, and package managers. This Skill walks them through the entire Buildertrend frontend setup in plain English, handling OS differences and recovering from common errors. ## Core Features & Use Cases - Automated prerequisite installation: Detects Mac or Windows, checks admin privileges, and installs Xcode CLT, Homebrew, fnm, Node.js 22, and pnpm only when missing. - Guided credential and clone flow: Walks users through generating Azure DevOps Git credentials, cloning the BTNet repository, and authenticating to the private npm package feed. - Environment configuration and launch: Creates the .env.development.local file, adds the local.buildertrend.net hosts entry, and starts the app via the preview skill. - Use Case: A product designer with no terminal experience runs the setup and ends with the Buildertrend frontend running at https://local.buildertrend.net:443/ connected to the shared test environment, plus optional Figma, Azure DevOps, and Confluence connections. ## Quick Start Ask Claude to set up the Buildertrend frontend on your computer for the first time.

Frequently Asked Questions about first-time-setup

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

FAQPage Schema
How do I set up the Buildertrend frontend locally as a non-developer?▼

Run the first-time-setup skill, which detects your OS, installs missing tools like Node.js 22 and pnpm, walks you through cloning the BTNet repo from Azure DevOps, configures the environment, and starts the app in your browser.

How do I clone the BTNet repository from Azure DevOps?▼

Open the BTNet repo in Azure DevOps, click Clone, then Generate Git Credentials to get a username and password. Run git clone with the HTTPS URL in your terminal and paste the generated password when prompted.

Does the setup work on both Mac and Windows?▼

Yes, the skill detects your operating system automatically and adjusts commands. Mac requires admin privileges and uses Homebrew, while Windows uses winget to install Git and fnm.

Why does pnpm install fail with a 401 Unauthorized error?▼

A 401 error means the private package feed authentication expired or failed. Re-run pnpm run setup-bt-feed-credentials or pnpm run setup-btfeedauth-crossplatform, signing in with your Buildertrend Microsoft account.

What should I do if I get out of memory errors during setup?▼

The project requires roughly 16GB of RAM. Machines with less memory may crash during install or startup, and there is no simple workaround other than using a more powerful machine.

Related Skills

Explore More Software Engineering Skills→
ownway22ownway22

azure-devops-cli

Manage Azure DevOps projects and Git workflows with command-line precision.

Community
Advanced
hemant0510hemant0510

dev

Start a local development server and verify the app in a browser.

Community
Basic
Arupbiswas09Arupbiswas09

boards-my-work

Retrieve Azure DevOps work items assigned to a user from a selected project.

Community
Intermediate
ClickHouseClickHouse
525

infra-clickhouse

Sets up local ClickHouse development servers and deploys managed ClickHouse Cloud services via clickhousectl.

Official
Intermediate