# Launch Local Dev Servers

Starting multi-service apps often requires repeated setup checks and commands. This skill guides Claude, Codex, or Claude Code through backend and frontend startup steps.

## Install

```bash
npx skillstore add applelamps/dev-servers
```

## Metadata

- Status: approved
- Slug: applelamps-dev-servers
- Skillstore revision: r1
- Version status: missing
- Tree hash: 89e37dfd901e2efb94577949b02247410e72a773fc9b0aafcfaf4df2a6d00df7
- Author: AppleLamps
- GitHub username: AppleLamps
- License: MIT
- Repository: https://github.com/AppleLamps/web-term/tree/main/.claude/skills/dev-servers
- Ref: 7db9b9f06e0ab79c575b58bc48c4d8dc9849f424
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, env\_access
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/applelamps-dev-servers
- Manifest: https://skillstore.pages.dev/api/skills/applelamps-dev-servers/manifest

## Capabilities

- Checks whether backend and frontend dependencies appear installed.
- Prompts for user confirmation before installing missing dependencies.
- Starts a FastAPI backend with uvicorn reload mode.
- Starts a Vite frontend development server.
- Warns when expected development ports may already be in use.
- Reminds the agent not to expose the OPENAI\_API\_KEY.

## Use Cases

- Start a full-stack app locally: Use the skill to launch both backend and frontend services during feature development.
- Prepare a repository for local testing: Use the dependency checks before running a project for the first time.
- Run an app before manual verification: Use the startup flow before testing UI changes in a browser.

## Prompt Templates

### Start the app

```
Start the dev servers for this project.
```

### Check setup first

```
Check whether the backend and frontend dependencies are installed, then start the dev servers if everything is ready.
```

### Install missing dependencies with confirmation

```
Prepare the backend and frontend for local development. Ask before installing missing dependencies, then launch both servers.
```

### Launch and report ports

```
Start the FastAPI and Vite development servers in the background, warn me about port conflicts, and report the local URLs when ready.
```

## Limitations

- Assumes backend and frontend directories use the documented names.
- Does not define project-specific health checks after startup.
- Requires a valid Python environment and Node installation.
- Cannot safely create or reveal secret values in environment files.

## Best Practices

- Review install commands before approving them in unfamiliar repositories.
- Keep environment files private and verify only that required keys exist.
- Stop background development servers when testing is complete.

## Anti Patterns

- Do not print .env contents or secret values into the chat.
- Do not run package installs in an untrusted repository without review.
- Do not assume localhost ports are free without checking conflicts.

## Security Audit

- Audited at: 2026-07-09T01:43:04.299\+00:00
- Summary: The static command findings are mostly expected for a skill that starts local development servers. Dependency installation and environment file checks remain real risks because they can run package manager commands and interact with secret configuration.

## Stats

- Views: 179
- Downloads: 10
- Favorites: 0
- Popularity score: 0
