🚀 Why Restartly?

Most reload tools are functional but generic. Restartly is a next-generation utility designed to make your development process feel as premium as your code.

- ⚡ Turbo Speed: Instant process reloads with sub-millisecond overhead.
- ✨ Premium UI: A beautiful, high-contrast terminal experience with custom ASCII art.
- 🌍 Universal Support: Native detection for Bun, Node.js, and all major frameworks.
- 🔍 Auto-Detection: Zero-config mode that finds your entry point automatically.
- ⌨️ Interactive CLI: Type rs to restart manually at any time.
- 🔐 Environment Support: Automatic .env loading powered by dotenv.
- 🛠️ Framework Intelligence: Built-in support for Hono, Remix, Astro, Next.js, and more.
- ⚙️ Powerfully Simple: Unified configuration via restartly.json.
- 🛡️ Reliable Runner: Advanced child process management with custom termination signals.
- 📦 Modern Stack: Built from the ground up with TypeScript and ESM.

---

🛠️ Installation

Get started in seconds. Install globally or as a dev dependency.

``bash


Install globally

npm install -g restartly

Or install in your project

npm install --save-dev restartly
`

---

⚡ Quick Start

Restartly is smarter than your average reloader.

$3

If you have an index.js, server.js, or app.js, just run:

`bash
restartly
`

$3

Specify your entry point explicitly:

`bash
restartly app.ts
`

$3

Restartly automatically detects and configures the best dev command for:

- Hono / Express / Fastify
- Next.js / Nuxt / Remix / Astro / SvelteKit
- NestJS / AdonisJS / Strapi
- Bun (Auto-switches to bun runtime)

$3

Need to run something else? Restartly handles it:

`bash
restartly --exec "python3 api.py"
`

---

⚙️ Configuration

Store your settings in a restartly.json file at the root of your project for a seamless experience.

`json
{
"script": "src/main.ts",
"watch": ["src", "config"],
"ignore": ["*/.test.ts", "dist"],
"debounce": 300,
"exec": "tsx"
}
`

$3

| Option | Shorthand | Description | Default |
| :----------- | :-------- | :----------------------------------- | :------------------- |
| --watch | -w | Paths to monitor for changes | . |
| --ignore | -i | Patterns to ignore (globs supported) | node_modules, .git |
| --exec | -x | Custom execution command | node |
| --debounce | -d | Delay before reload (ms) | 200 |
| --delay | -l | Delay before restarting (ms) | 0 |
| --signal | -s | Signal to send for termination | SIGTERM |
| --polling | -p | Use file system polling | false |
| --env | -e | Path to .env file | .env |
| --verbose | -v | Enable verbose logging | false |
| --quiet | -q | Enable quiet mode | false |
| --config | -c | Path to custom config file | restartly.json |
| --list | | List all commands and flags | - |

---

🎨 Premium Experience

Restartly isn't just a tool; it's a visual upgrade for your terminal. Experience a high-performance runner that actually looks good while you work.

---

🤝 Contributing

We love contributions! Whether it's a bug fix, a new feature, or an improvement to the documentation, feel free to open a Pull Request.

1. Fork the Repository
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

Distributed under the MIT License. See LICENSE` for more information.