↺ Restartly Ultra

v1.3.3 - The Premium Automatic Reload Tool for Modern Developers

High-performance. Developer-friendly. Stylish.
Built for speed, styled for impact, and designed to keep you in the flow.

Website • Documentation • GitHub

🚀 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.

# 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.

Zero Config (Auto-Detect)

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

restartly

Manual Mode

Specify your entry point explicitly:

restartly app.ts

Framework Support

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)

Custom Execution

Need to run something else? Restartly handles it:

restartly --exec "python3 api.py"

⚙️ Configuration

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

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

CLI Options

| 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.

Built with ❤️ by TheNeovimmer