Skip to content

⚡ A fast, zero-dependency file watcher for Go — built entirely with the standard library. 🔥 Auto-restart your Go apps on file change.

License

Notifications You must be signed in to change notification settings

ayushdoesdev/goblip

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GoBlip

GoBlip is a lightweight, dependency-free watcher for Go projects.
It detects file changes (“blips”) and restarts your Go app automatically.

🧩 Gin support: GoBlip works seamlessly with the Gin framework.

Run your Gin server with goblip -- go run . and enjoy automatic reload on file changes.

v1.0.0 Released


💡 Why GoBlip?

The best part — GoBlip uses zero external libraries.
It’s built entirely with the Go standard library, which makes it:

  • Fast: minimal overhead and instant startup
  • 🔒 Safe: no dependency vulnerabilities or supply-chain risks
  • 🧩 Stable: powered only by Go’s well-supported core packages
  • 🛠️ Long-term reliable: works across all future Go versions without maintenance headaches

This means GoBlip will keep working for years — fast, clean, and dependency-free.


🚀 Features

  • No external dependencies — just Go’s standard library
  • Cross-platform (macOS, Linux, Windows)
  • Clean modular structure (cmd/, internal/)
  • Configurable poll interval and file types
  • Graceful shutdown via signals (Ctrl+C)

🧩 Installation

Clone or install:

go install github.com/ayushdoesdev/goblip/cmd/goblip@latest

Make sure your Go bin directory is in your PATH:

export PATH="$PATH:$(go env GOPATH)/bin"

🧠 Usage

# Default: go run your project automatically
goblip

# Run a specific command
goblip -- go run ./cmd/server

# Verbose output
goblip -v -- go run main.go

# Custom poll interval and extensions
goblip -interval 250ms -ext ".go,.tpl" -- go run .

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a feature branch:
   git checkout -b feature/your-feature
  1. Make your changes
  2. Run formatting and vet:
  go fmt ./...
  go vet ./...
  1. Commit and open a Pull Request

About

⚡ A fast, zero-dependency file watcher for Go — built entirely with the standard library. 🔥 Auto-restart your Go apps on file change.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages