Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 63 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
# πŸͺ¨ grug-group420 Portal

> "complexity very very bad" β€” grug

The official interactive portal and playground for [grug-group420](https://github.com/grug-group420).

🌐 **Live:** [grug-group420.github.io/portal](https://grug-group420.github.io/portal)

---

## ✨ Features

- **Live CLI Playground** β€” Try `grugbot420` commands directly in your browser
- **Project Showcase** β€” Browse all grug-group420 tools in one place
- **Zero Dependencies** β€” Pure HTML/CSS/JS, no frameworks, no build step
- **Run Locally** β€” One-click install instructions with copy buttons

## πŸš€ Quick Start

```bash
# Clone and open
git clone https://github.com/grug-group420/portal.git
cd portal
open index.html
# or
python3 -m http.server 8000
```

No build step. No bundler. No node_modules. Just open the file. Grug way.

## πŸ› οΈ Projects Featured

| Project | Description | Language |
|---------|-------------|----------|
| [grugbot420](https://github.com/grug-group420/grugbot420) | Neuromorphic cognitive engine | Julia |
| [Bindboss](https://github.com/grug-group420/Bindboss) | Self-extracting executable packer | Go |
| [grugbot-server](https://github.com/grug-group420/grugbot-server) | AI CLI assistant | JavaScript/Bun |
| [grug-cli](https://github.com/grug-group420/grug-cli) | Zero-dep developer toolkit | JavaScript/Bun |

## πŸ“ Structure

```
portal/
β”œβ”€β”€ index.html # Main page + playground
β”œβ”€β”€ styles.css # All styling
└── app.js # Playground logic
```

Three files. That's it. Grug approve.

## 🀝 Contributing

See [CONTRIBUTING.md](https://github.com/grug-group420/.github/blob/main/CONTRIBUTING.md) for guidelines.

Ideas:
- Add new playground commands
- Improve mobile responsiveness
- Add dark/light theme toggle
- Animate the grug mascot

## πŸ“œ License

Part of [grug-group420](https://github.com/grug-group420). Ship code, not complexity. πŸͺ¨