[{"_1":2,"_187":-5,"_188":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_162":163},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_92":-5,"_93":94,"_151":-5,"_152":11,"_153":21,"_154":11,"_155":-5,"_156":11,"_157":-5,"_158":159,"_160":95,"_161":-7},"canonicalUrl","https://hub.docker.com/r/mukezhz/heynats/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","mukezhz","reponame","heynats","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_47":48,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":60,"_43":35,"_32":33,"_62":63,"_64":49,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":66,"_73":74,"_75":11,"_76":33,"_77":78,"_83":11,"_84":85,"_89":33,"_90":91},"categories",[42],{"_43":44,"_45":46},"name","Monitoring & observability","slug","monitoring-and-observability","content_types",[49],"image","date_registered","2025-09-26T16:25:53.590417Z","description","A simple and powerful web UI to monitor, explore, and interact with your NATS in real time.","is_private","last_updated","2026-09-26T12:33:10.953757Z","last_modified","2026-04-09T03:07:05.690207Z","media_types",[61],"application/vnd.oci.image.index.v1+json","pull_count",2118,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# HeyNATS 🚀\n\n

\n\n![HeyNATS Logo](client/public/heynats.png)\n\n**A modern, web-based administration interface for NATS Server**\n\n[![Built with React](https://img.shields.io/badge/React-19-blue.svg)](https://reactjs.org/)\n[![Go Version](https://img.shields.io/badge/Go-1.24.0+-00ADD8.svg)](https://golang.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.7+-3178C6.svg)](https://www.typescriptlang.org/)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE.md)\n\n[Demo](#-demo) •\n[Features](#-features) •\n[Quick Start](#-quick-start) •\n[Installation](#-installation) •\n[Documentation](#-documentation) •\n[Contributing](#-contributing)\n\n

\n\n---\n\n## 📖 What is HeyNATS?\n\nHeyNATS is a modern, intuitive web-based administration interface for [NATS Server](https://nats.io/). It provides a user-friendly dashboard to manage NATS connections, streams, consumers, and key-value stores without needing command-line expertise.\n\nThink of it as \"phpMyAdmin for NATS\" - making NATS server management accessible through a beautiful, responsive web interface.\n\n## 🎮 Demo\n\nExperience HeyNATS without any setup! Try our live demo using the public NATS server:\n\n### 🌐 Quick Demo Setup\n\n**Connection Details:**\n```\nHost: demo.nats.io\nPort: 4222\nAuthentication: None required\n```\n\n### 📱 Demo Screenshots\n\n

\n\n**Login Screen**\n![Login page with demo credentials](./docs/images/demo_login.png)\n\n**Dashboard Overview**\n![Dashboard page after successful login](./docs/images/dashboard.png)\n\n

\n\n> **💡 Tip**: The demo server is public, so you might see data from other users. This is normal and demonstrates HeyNATS's real-time capabilities!\n\n## ✨ Features\n\n### 🔌 **Connection Management**\n- Connect to multiple NATS servers simultaneously\n- Support for authentication (user/password, token, JWT)\n- Real-time connection status monitoring\n- Connection pooling and management\n\n### 📊 **JetStream Administration**\n- **Stream Management**: Create, view, edit, and delete streams\n- **Consumer Management**: Monitor and manage stream consumers\n- **Message Publishing**: Send messages to streams and subjects\n- **Message Consumption**: Subscribe to streams and view real-time messages\n\n### 🗄️ **Key-Value Store Operations**\n- Create and manage KV buckets\n- Browse, add, edit, and delete key-value pairs\n- Real-time KV operations monitoring\n- Bucket configuration management\n\n### 📈 **Monitoring & Analytics**\n- Real-time server statistics and metrics\n- Stream and consumer performance monitoring\n- Message flow visualization\n- Connection health dashboards\n\n### 🎨 **Modern UI/UX**\n- Responsive design that works on desktop, tablet, and mobile\n- Dark/light theme support\n- Intuitive navigation and user experience\n- Real-time updates without page refresh\n\n## 🛠️ Tech Stack\n\n### Frontend\n- **React 19** - Modern React with latest features\n- **TypeScript** - Type-safe development\n- **React Router v7** - Advanced routing with loaders\n- **TanStack Query** - Server state management and caching\n- **TailwindCSS 4** - Utility-first styling\n- **Vite** - Lightning-fast build tool\n- **shadcn/ui** - Beautiful, accessible component library\n\n### Backend\n- **Go 1.24.0+** - High-performance backend\n- **Gin Framework** - Fast HTTP web framework\n- **NATS Go Client** - Official NATS client library\n- **Graceful Shutdown** - Proper resource cleanup\n\n## 🏗️ Project Structure\n\n```\nheynats/\n├── main.go # Go server entry point\n├── internal/ # Backend Go modules\n│ ├── api/ # API handlers (NATS, KV, Streams)\n│ ├── infrastructure/ # Router and middleware\n│ ├── model/ # Data models\n│ └── pkg/ # NATS client package\n├── client/ # React frontend application\n│ ├── src/\n│ │ ├── components/ # Reusable UI components\n│ │ ├── pages/ # Page components\n│ │ ├── hooks/ # Custom React hooks\n│ │ ├── lib/ # Utilities and API client\n│ │ └── providers/ # Context providers\n│ ├── dist/ # Built frontend (served by Gin)\n│ └── package.json\n├── docs/ # Documentation\n├── Makefile # Build automation\n├── build-and-run.sh # Quick start script\n├── dev.sh # Development mode script\n└── docker-compose.yml # Docker setup\n```\n\n## 🚀 Quick Start\n\n### Option 1: Try the Demo First! 🎮\nNo installation needed - just try HeyNATS with our [demo setup](#-demo) using `demo.nats.io`.\n\n### Option 2: Install Locally\nThe fastest way to get HeyNATS running on your machine:\n\n```bash\n# Clone the repository\ngit clone https://github.com/Astergaze-Solutions/heynats.git\ncd heynats\n\n# Quick build and run (recommended for first-time users)\n./build-and-run.sh\n\n# Open your browser to http://localhost:5000\n```\n\nThat's it! HeyNATS will be running and ready to connect to your NATS server.\n\n## 💻 Installation\n\n### Prerequisites\n\n#### System Requirements\n- **Go 1.24.0 or later** - [Download Go](https://golang.org/dl/)\n- **Node.js 18+ and pnpm** - [Install Node.js](https://nodejs.org/) and [Install pnpm](https://pnpm.io/installation)\n- **NATS Server** - [Install NATS Server](https://docs.nats.io/running-a-nats-service/introduction/installation)\n\n```bash\n# Install pnpm globally\nnpm install -g pnpm\n\n# Verify installations\ngo version # Should be 1.24.0+\nnode --version # Should be 18+\npnpm --version\n```\n\n### Full Installation\n\n1. **Clone the repository**\n ```bash\n git clone https://github.com/Astergaze-Solutions/heynats.git\n cd heynats\n ```\n\n2. **Install dependencies**\n ```bash\n # Install all dependencies (Go + Node.js)\n make install\n \n # Or manually:\n go mod tidy\n cd client && pnpm install && cd ..\n ```\n\n3. **Setup development tools** (Optional but recommended)\n ```bash\n # Install lefthook for Git hooks\n go install github.com/evilmartians/lefthook@latest\n lefthook install\n \n # Install Go development tools\n go install golang.org/x/tools/cmd/goimports@latest\n go install github.com/air-verse/air@latest # For hot reload\n ```\n\n## 🎯 Usage\n\n### Starting HeyNATS\n\n#### Option 1: Production Build (Recommended)\n```bash\n# Build and run in one command\n./build-and-run.sh\n\n# Or using Makefile\nmake run\n```\n\n#### Option 2: Development Mode (Hot Reload)\n```bash\n# Start both frontend and backend with hot reload\n./dev.sh\n\n# Or using Makefile\nmake dev-full\n```\n\n### Connecting to NATS Server\n\n1. **Access HeyNATS**: Open http://localhost:5000 in your browser\n\n2. **Create a Connection**: Click \"New Connection\" and configure:\n\n **For Demo/Testing:**\n - **Server URL**: `nats://demo.nats.io:4222`\n - **Name**: \"Demo Server\" (or any friendly name)\n - **Authentication**: Leave blank (no auth required)\n\n **For Local Development:**\n - **Server URL**: `nats://localhost:4222` (default local NATS server)\n - **Name**: \"Local NATS\" (or any friendly name)\n - **Authentication**: Configure if your NATS server requires auth\n\n3. **Start Managing**: Once connected, you can:\n - Create and manage JetStream streams\n - Publish and subscribe to messages\n - Manage Key-Value stores\n - Monitor server statistics\n\n### Available URLs\n- **Web Interface**: http://localhost:5000\n- **API Endpoints**: http://localhost:5000/api/*\n- **React Dev Server** (dev mode): http://localhost:5173\n\n## 🔧 Development\n\n### Available Commands\n\n```bash\n# Development\nmake dev-full # Start both frontend and backend with hot reload\nmake dev # Start only React dev server\n./dev.sh # Alternative script for development mode\n\n# Production\nmake run # Build and run production version\n./build-and-run.sh # Quick production build script\n\n# Building\nmake build # Build both frontend and backend\nmake build-client # Build only React frontend\n\n# Utilities\nmake install # Install all dependencies\nmake clean # Clean build artifacts\nmake help # Show all available commands\n```\n\n### Development Architecture\n\n- **Frontend**: React dev server runs on `:5173` with hot reload and proxies API calls to `:5000`\n- **Backend**: Go server runs on `:5000` serving both API endpoints and static files\n- **Live Reload**: Frontend changes reflect immediately, backend changes require restart (use `air` for hot reload)\n\n## 🐳 Docker Support\n\nRun HeyNATS with Docker Compose:\n\n```bash\n# Start HeyNATS with NATS server\ndocker-compose up -d\n\n# Access at http://localhost:5000\n# NATS server available at nats://localhost:4222\n```\n\n## 📚 Documentation\n\n- [Architecture Overview](docs/ARCHITECTURE.md) - Detailed technical architecture\n- [Connection Management](docs/CONNECTION_MANAGEMENT.md) - NATS connection handling\n- [Frontend Integration](docs/FRONTEND_INTEGRATION.md) - React and API integration\n- [UI Improvements](docs/UI_IMPROVEMENTS.md) - UI/UX design decisions\n\n## 🧪 Testing\n\n```bash\n# Run Go tests\ngo test ./...\n\n# Run frontend tests\ncd client && pnpm test\n\n# Run linting\nmake lint # Lint both Go and TypeScript\ncd client && pnpm lint # Frontend only\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please read our [Contributing Guidelines](CONTRIBUTING.md) for detailed information on:\n\n- 🐛 Reporting bugs\n- 💡 Suggesting features \n- 💻 Code contributions\n- 📝 Documentation improvements\n- 🔧 Development setup\n\n**Quick start for contributors:**\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Commit your changes: `git commit -m 'Add amazing feature'`\n4. Push to the branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\n### Development Setup for Contributors\n\n```bash\n# Clone your fork\ngit clone https://github.com/your-username/heynats.git\ncd heynats\n\n# Install dependencies\nmake install\n\n# Setup pre-commit hooks\nlefthook install\n\n# Start development\nmake dev-full\n```\n\n### Modern way:\n\n```bash\ndocker buildx build --platform linux/amd64,linux/arm64 -t --push .\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.\n\n## 👩‍💻 Contributors\n\nWe're grateful to all the amazing people who have contributed to HeyNATS! 🎉\n\n\n\n $\"Contributors\"$ \n\n\nMade with [contrib.rocks](https://contrib.rocks).\n\n### How to Contribute\n\nWant to see your profile here? We'd love your contributions! Check out our [Contributing Guidelines](CONTRIBUTING.md) to get started.\n\n### Core Maintainers\n\n- **[@mukezhz](https://github.com/mukezhz)** - Project Lead & Core Developer\n- **[@SushantBabu](https://github.com/SushantBabu97)** - Core Developer\n- **[@Astergaze-Solutions](https://github.com/Astergaze-Solutions)** - Organization & Project Sponsor\n\n*Interested in becoming a maintainer? Contribute regularly and reach out to us!*\n\n## 🙏 Acknowledgments\n\n- **NATS.io** - For the amazing NATS messaging system\n- **Adminer** - UI/UX inspiration for database administration tools\n- **shadcn/ui** - Beautiful component library\n- **TailwindCSS** - Utility-first CSS framework\n\n## 📞 Support\n\n- **Issues**: [GitHub Issues](https://github.com/Astergaze-Solutions/heynats/issues)\n- **Documentation**: [docs/](docs/)\n- **NATS Community**: [NATS Slack](https://nats.io/community/)\n\n---\n\n

Made with ❤️ by the Astergaze Solutions team

⭐ Star this project if you find it helpful!

\n","has_starred","hub_user","immutable_tags_settings",{"_79":11,"_80":81},"enabled","rules",[82],".*","is_automated","permissions",{"_86":21,"_87":11,"_88":11},"read","write","admin","user","storage_size",208421784,"orgData","recentTags",[95],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_105":106,"_55":139,"_140":98,"_141":33,"_142":61,"_43":143,"_144":145,"_146":147,"_148":139,"_149":70,"_150":21},"content_type","creator",10103278,"digest","sha256:292021117d31bf11ec33379b5f86a4730551eddd19266ff63bb465a2dd1b5887","full_size",13062986,"id",980325999,"images",[107,123,129,135],{"_108":109,"_99":110,"_111":112,"_113":114,"_115":116,"_117":118,"_119":112,"_120":-5,"_121":102,"_67":70,"_122":-5},"architecture","amd64","sha256:088e0b4de3b6d1b8d059ad53a014d296b18a737a5d382d3974ee0bbc6c2ea504","features","","last_pulled","2026-10-05T12:29:23.287389898Z","last_pushed","2026-09-26T12:33:05.320944222Z","os","linux","os_features","os_version","size","variant",{"_108":124,"_99":125,"_111":112,"_113":126,"_115":127,"_117":118,"_119":112,"_120":-5,"_121":128,"_67":70,"_122":-5},"arm64","sha256:808b272a133510b81c885d646fa6501e4fccc4169fadf936a65d36b39b1742cb","2026-10-05T14:20:59.368116824Z","2026-09-26T12:33:06.387553437Z",12508321,{"_108":130,"_99":131,"_111":112,"_113":132,"_115":133,"_117":130,"_119":112,"_120":-5,"_121":134,"_67":70,"_122":-5},"unknown","sha256:e874af80b912482a6a11c75d6202070a4bdad5c752d24c239216b2e9e984fcdf","2026-09-29T19:01:43.189915321Z","2026-09-26T12:33:08.605931085Z",1525,{"_108":130,"_99":136,"_111":112,"_113":137,"_115":138,"_117":130,"_119":112,"_120":-5,"_121":134,"_67":70,"_122":-5},"sha256:de3e00d48d7e1e6703170108794ecafd5c5bc8d909ec5f7668ceab31878e44e8","2026-09-29T19:01:43.084891506Z","2026-09-26T12:33:07.418430734Z","2026-09-26T12:33:10.117001Z","last_updater","last_updater_username","media_type","latest","repository",28683140,"tag_last_pulled","2026-10-06T07:19:42.535915469Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":164,"_172":173,"_158":185,"_186":11},{"_40":165,"_47":167,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":168,"_43":35,"_32":33,"_62":63,"_64":49,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":66,"_73":74,"_75":11,"_76":33,"_77":169,"_83":11,"_84":171,"_89":33,"_90":91},[166],{"_43":44,"_45":46},[49],[61],{"_79":11,"_80":170},[82],{"_86":21,"_87":11,"_88":11},"tags",{"_174":68,"_175":-5,"_176":-5,"_177":178},"count","next","previous","results",[179],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_105":180,"_55":139,"_140":98,"_141":33,"_142":61,"_43":143,"_144":145,"_146":147,"_148":139,"_149":70,"_150":21},[181,182,183,184],{"_108":109,"_99":110,"_111":112,"_113":114,"_115":116,"_117":118,"_119":112,"_120":-5,"_121":102,"_67":70,"_122":-5},{"_108":124,"_99":125,"_111":112,"_113":126,"_115":127,"_117":118,"_119":112,"_120":-5,"_121":128,"_67":70,"_122":-5},{"_108":130,"_99":131,"_111":112,"_113":132,"_115":133,"_117":130,"_119":112,"_120":-5,"_121":134,"_67":70,"_122":-5},{"_108":130,"_99":136,"_111":112,"_113":137,"_115":138,"_117":130,"_119":112,"_120":-5,"_121":134,"_67":70,"_122":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
088e0b4de3b6	linux/amd64	12.46 MB
808b272a1335	linux/arm64	11.93 MB

mukezhz/heynats

Tags for mukezhz/heynats