{"id":28372024,"url":"https://github.com/lmlk-seal/dev-starter","last_synced_at":"2026-05-19T04:12:44.447Z","repository":{"id":295194526,"uuid":"989444965","full_name":"LMLK-seal/dev-starter","owner":"LMLK-seal","description":"NPM Development Launcher","archived":false,"fork":false,"pushed_at":"2025-05-27T12:18:43.000Z","size":1076,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-21T09:55:53.417Z","etag":null,"topics":["automation","code","dev","developer","developer-tools","lightweight","luncher","nodejs","npm","python","server"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LMLK-seal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-24T05:34:55.000Z","updated_at":"2025-06-17T21:00:22.000Z","dependencies_parsed_at":"2025-05-24T06:31:58.267Z","dependency_job_id":"a74e097e-7e49-41a2-8a13-39af00580d0c","html_url":"https://github.com/LMLK-seal/dev-starter","commit_stats":null,"previous_names":["lmlk-seal/dev-starter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/LMLK-seal/dev-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LMLK-seal%2Fdev-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LMLK-seal%2Fdev-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LMLK-seal%2Fdev-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LMLK-seal%2Fdev-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LMLK-seal","download_url":"https://codeload.github.com/LMLK-seal/dev-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LMLK-seal%2Fdev-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33201543,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"online","status_checked_at":"2026-05-19T02:00:06.763Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","code","dev","developer","developer-tools","lightweight","luncher","nodejs","npm","python","server"],"created_at":"2025-05-29T11:44:28.114Z","updated_at":"2026-05-19T04:12:44.394Z","avatar_url":"https://github.com/LMLK-seal.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NPM Development Launcher\n\n![dev-starter Chat Demo](https://raw.githubusercontent.com/LMLK-seal/dev-starter/refs/heads/main/dev-starter.gif)\n\nA Python script that automates the process of starting your npm development and opening it in your browser. Perfect for streamlining your web development workflow!\n\n## 🚀 Features\n\n- **Cross-Platform**: Works seamlessly on Windows, macOS, and Linux\n- **Smart Terminal Detection**: Automatically finds and uses available terminal emulators\n- **Server Readiness Check**: Waits for your dev server to be fully ready before opening the browser\n- **Configurable**: Easy to customize for different ports and timeouts\n- **Error Handling**: Graceful fallbacks and clear error messages\n\n## 📋 Prerequisites\n\n- Python 3.6 or higher\n- Node.js and npm installed\n- A project with `npm run dev` script configured\n\nInstall the required Python package:\n```bash\npip install requests\n```\n\n## 🛠️ Installation\n\n1. Download the `run.py` or `run2.py` script (Read useage for the difference between them)\n2. Place it in your project's root directory (same level as your `package.json`)\n3. Make sure it's executable (Linux/macOS):\n   ```bash\n   chmod +x run.py\n   ```\n4. Windows: No additional setup needed - Python files run directly.\n\n## 🎯 Usage\n\nOpen and run the script `Run.py` from your project directory.\n\n### What happens next:\n1. 🖥️ Opens a new terminal window\n2. 🏃 Runs `npm run dev` in that terminal\n3. ⏳ Waits for the development server to start\n4. 🌐 Automatically opens your browser to `http://localhost:5173`\n\nOpen and run the script `Run2.py` from your project directory.\n\n### What happens next:\n1. 📝 Checks if dependencies are installed (node_modules).\n2. 🔧 Runs npm install if necessary.\n3. 🖥️ Opens a new terminal window\n4. 🏃 Runs `npm run dev` in that terminal\n5. ⏳ Waits for the development server to start\n6. 🌐 Automatically opens your browser to `http://localhost:5173`\n\nNote: \nIf dependencies are already installed the program will skip this part and runs `npm run dev`.\n\n## ⚙️ Configuration\n\nYou can customize the script by modifying these variables at the top of `run.py`:\n\n```python\nLOCALHOST_PORT = 5173          # Change if your project uses a different port\nSERVER_CHECK_TIMEOUT = 60      # How long to wait for server (seconds)\nRETRY_INTERVAL = 1             # Check frequency (seconds)\n```\n\n### Common Port Configurations:\n- **Vite**: 5173 (default)\n- **Create React App**: 3000\n- **Next.js**: 3000\n- **Vue CLI**: 8080\n- **Angular**: 4200\n\n## 🖥️ Platform-Specific Behavior\n\n### Windows\n- Uses Command Prompt (`cmd`)\n- Keeps the terminal window open after npm command\n\n### macOS\n- Uses Terminal.app\n- Creates a new tab/window with the running process\n\n### Linux\n- Tries multiple terminal emulators in order:\n  - gnome-terminal\n  - konsole\n  - xfce4-terminal\n  - terminator\n  - lxterminal\n  - xterm\n  - x-terminal-emulator\n\n## 🔧 Troubleshooting\n\n### \"requests library not installed\"\n```bash\npip install requests\n```\n\n### Server doesn't start or wrong port\n- Check your `package.json` scripts section\n- Verify the correct port in the configuration\n- Ensure your project has `npm run dev` configured\n\n### Terminal doesn't open (Linux)\n- Install a supported terminal emulator\n- Or run `npm run dev` manually after the script reports the issue\n\n### Browser doesn't open automatically\n- The script will still work; manually navigate to the displayed URL\n- Check if `webbrowser` module can access your default browser\n\n## 📁 Project Structure Example\n\n```\nmy-web-project/\n├── package.json\n├── run.py          ← Place the script here\n├── src/\n├── public/\n└── ...\n```\n\n## 🤝 Contributing\n\nFeel free to submit issues, suggestions, or improvements! This script is designed to be simple and easily customizable for different development workflows.\n\n## 📝 License\n\nThis script is provided as-is for development convenience. Feel free to modify and distribute according to your needs.\n\n---\n\n**Happy coding! 🎉**\n\n*No more manually opening terminals and browsers - let Python handle the boring stuff while you focus on building amazing applications.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flmlk-seal%2Fdev-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flmlk-seal%2Fdev-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flmlk-seal%2Fdev-starter/lists"}