Function runNormalMode

internal/cli/acul_dev.go:164–226

(cli *cli, projectDir, port string)

}

func runNormalMode(cli *cli, projectDir, port string) error {
	if !isPortFree(port) {
		return fmt.Errorf("port %s is already in use; please free it or choose another port", port)
	}

	// 1. Set up the command.
	cmd := exec.Command("npm", "run", "dev", "--", "--port", port)
	cmd.Dir = projectDir

	// 2. Set up output pipes/redirection.
	stdout, err := cmd.StdoutPipe()
	if err != nil {
		return fmt.Errorf("failed to capture stdout: %w", err)
	}

	if cli.debug {
		cmd.Stderr = os.Stderr
		fmt.Println("\n🔄 Executing:", ansi.Cyan("npm run dev -- --port "+port))
	}

	// 3. Start the command asynchronously.
	if err := cmd.Start(); err != nil {
		return fmt.Errorf("failed to start 'npm run dev -- --port %s': %w", port, err)
	}

	// 4. Print the success/info logs immediately after starting the server process.
	server := fmt.Sprintf("http://localhost:%s", port)

	// 5. Wait for the command to exit and handle intentional stops (Ctrl+C).
	readyChan := make(chan struct{})
	go func() {
		scanner := bufio.NewScanner(stdout)
		for scanner.Scan() {
			line := scanner.Text()
			fmt.Println(line)
			if strings.Contains(line, "Local:") && strings.Contains(line, "http") {
				close(readyChan)
				return
			}
		}
	}()

	select {
	case <-readyChan:
		fmt.Println("💡 " + ansi.Italic("Make changes to your code and view the live changes as we have HMR enabled!"))
		_ = browser.OpenURL(server)

	case <-time.After(20 * time.Second):
		fmt.Println("⏳ Dev server is taking longer than expected to start...")
	}

	if err = cmd.Wait(); err != nil {
		if exitErr, ok := err.(*exec.ExitError); ok && exitErr.ExitCode() == 130 {
			fmt.Println(ansi.Bold("\n👋 Server stopped intentionally (Ctrl+C)."))
			return nil
		}

		return fmt.Errorf("dev server exited with an error: %w", err)