start-local-servers

Free conflicting ports and launch Flask backend and Vite frontend servers.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jarodmeng/daydreamedu-scripts --skill start-local-servers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-local-servers
Source: https://github.com/jarodmeng/daydreamedu-scripts/tree/main/.cursor/skills/start-local-servers
Command: npx skills add https://github.com/jarodmeng/daydreamedu-scripts --skill start-local-servers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starts the Chinese chr app local dev servers for testing.

Core Features & Use Cases

  • Frees ports 5001 and 3000 to avoid conflicts.
  • Starts the Flask backend and Vite frontend in the background.
  • Works from the repository root to set up a local testing environment.

Quick Start

Run from the repository root to kill processes on ports 5001 and 3000, then start the Flask backend and Vite frontend in the background.

Frequently Asked Questions about start-local-servers

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

FAQPage Schema
How do I start local Flask and Vite development servers at the same time?

To start local Flask and Vite development servers simultaneously, run the startup command from the repository root. It launches the Flask backend and Vite frontend in the background, establishing a complete local testing environment.

How do I free ports 5001 and 3000 when they are already in use?

To free ports 5001 and 3000 when they are already in use, execute the local server startup command. It automatically identifies and kills conflicting processes on these specific ports before initializing the backend and frontend environments.

What is the correct directory context for launching a local Flask and Vite dev environment?

The correct directory context for launching a local Flask and Vite dev environment is the repository root. Running the startup process from this location ensures proper port cleanup, background process management, and correct path resolution for both stacks.

Why does my local Vite or Flask server fail to start due to background process conflicts?

Your local Vite or Flask server fails to start due to background process conflicts when ports 5001 and 3000 remain occupied. The startup command manages background processes and frees these ports to resolve the conflict and allow testing.

Can I run local backend and frontend tests after starting the dev servers?

Yes, you can run local backend and frontend tests after starting the dev servers. The command sets up a local testing environment by launching the Flask and Vite stacks in the background, making the app accessible for browser demos and test execution.