local-development

name	local-development
description	Running functions and web app locally, troubleshooting emulator issues, Storybook. Use when running or debugging locally.

Local Development

When to Use

Use this skill when running the web app or functions locally, troubleshooting emulator issues, or running Storybook.

Important

The user runs functions and web app locally for testing. Claude writes code and creates PRs -- Claude does NOT deploy or run dev servers.

Running Functions Locally (user runs this)

npx nx run functions:serve

This command:

1. Builds the functions
2. Copies .env.dev to dist/apps/functions/.env
3. Starts watch mode for rebuilds (background)
4. Runs firebase serve --only functions --project=dev on port 5001

Running Web App Locally (user runs this)

npx nx run maple-spruce:serve

Runs on http://localhost:3000

Running Storybook

npx nx run maple-spruce:storybook
# Opens http://localhost:6006

Building Storybook:

npx nx run maple-spruce:build-storybook
# Output: dist/storybook/maple-spruce

Running Tests

npm test

Deployment

User decides when to deploy to dev. Production deploys automatically via CI/CD on merge to main.

Troubleshooting Local Functions

Emulator prompts for environment variables