runbay 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jerem
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,97 @@
+<div align="center">
+
+<img src="build/icon.png" alt="RunBay" width="96" />
+
+# RunBay
+
+**Not an installer. A launcher.**
+
+[Français](README.md) · **English**
+
+</div>
+
+Package managers are great at installing things. They are terrible at showing you what you **already** have, letting you run it, and telling you what's out of date. **RunBay** fixes that: it finds every app and CLI you installed from the command line — **npm, pnpm, yarn, bun, scoop** — and puts them in one fast, modern window.
+
+## 🖥️ The interface
+
+![RunBay main window](assets/screenshots/main.png)
+
+## ✨ What it does
+
+- **Detects** everything installed through the package managers actually present on your machine — nothing invented, RunBay reads what your managers already know
+- **Launches** any of them in one click — interactive CLIs open in a real console
+- **Updates** only when a newer version actually exists — with *Update all*, and *ignore this version* when the nag gets old
+- **Uninstalls** with a real confirmation dialog, never an accidental click
+- **Desktop shortcuts** for the tools you use every day
+- **Detail panel**: description, homepage, exposed binaries, install location
+- **Tray mode**: close the window and RunBay keeps scanning quietly, then notifies you when something can be updated
+- **Light and dark themes**, collapsible sidebar, instant search, per-source colors
+
+## 🔄 RunBay updates itself
+
+When a newer version lands on npm, a yellow dot appears in the app. One click: it reinstalls and restarts on its own. No more remembering `npm update -g`.
+
+## 📦 Supported sources
+
+| Source | Detect | Launch | Uninstall | Update |
+|---|---|---|---|---|
+| npm (global) | ✅ | ✅ | ✅ | ✅ |
+| pnpm (global) | ✅ | ✅ | ✅ | ✅ |
+| yarn v1 (global) | ✅ | ✅ | ✅ | ✅ |
+| bun (global) | ✅ | ✅ | ✅ | ✅ |
+| scoop | ✅ | ✅ | ✅ | ✅ |
+
+## ⚙️ Installation
+
+> **Prerequisite: [Node.js](https://nodejs.org) must be installed** (LTS recommended). This is required — without Node.js, RunBay can neither install nor run.
+
+RunBay ships through npm (no installer, no SmartScreen):
+
+```bash
+npm install -g runbay
+runbay
+```
+
+Or try it once, without installing anything:
+
+```bash
+npx runbay
+```
+
+## 🔧 Daily use
+
+Select an app to open its detail — version, source, install location, exposed binaries — then launch it, create a shortcut, or uninstall it.
+
+![Detail panel](assets/screenshots/detail.png)
+
+Right-click opens a menu grouped by intent: *Run*, *Manage*.
+
+![Context menu](assets/screenshots/context.png)
+
+The **Options** button holds every setting: theme, startup, tray, welcome guide — and updating RunBay itself.
+
+![Options menu](assets/screenshots/options.png)
+
+## 🧩 Why "not an installer"
+
+An installer adds things to your machine. A launcher gets you *to* the things you already have. RunBay never installs anything for you — it reads what npm, pnpm, yarn, bun and scoop already know, and turns that list into a place you can actually work: launch, update, remove, shortcut. The command line stays your install tool; RunBay is your run tool.
+
+## 👨‍💻 Development
+
+```bash
+npm install
+npm run dev          # the app with hot reload
+npm run typecheck    # type checking
+npm run build        # production bundles
+npm run package:win  # Windows installer (electron-builder)
+```
+
+Each source is an isolated **provider** (`src/main/providers/`): adding a new one means adding one file that implements the `Provider` interface.
+
+## ☕ Support
+
+[Buy Me a Coffee — skroproduction](https://buymeacoffee.com/skroproduction)
+
+## License
+
+MIT

package/README.md

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="build/icon.png" alt="RunBay" width="96" />
+
+# RunBay
+
+**Pas un installateur. Un lanceur.**
+
+**Français** · [English](README.en.md)
+
+</div>
+
+Les gestionnaires de paquets installent très bien les choses. Ils sont terribles pour vous montrer ce que vous avez **déjà**, vous permettre de le lancer, et vous dire ce qui n'est pas à jour. **RunBay** corrige ça : il détecte toutes les apps et CLI installées en ligne de commande — **npm, pnpm, yarn, bun, scoop** — et les réunit dans une seule fenêtre, rapide et moderne.
+
+## 🖥️ L'interface
+
+![Fenêtre principale de RunBay](assets/screenshots/main.png)
+
+## ✨ Fonctionnalités
+
+- **Détection** de tout ce qui est installé via les gestionnaires réellement présents sur votre machine — rien d'inventé, RunBay lit ce que vos gestionnaires savent déjà
+- **Lancement** en un clic — les CLI interactifs s'ouvrent dans une vraie console
+- **Mises à jour** uniquement quand une version plus récente existe vraiment — avec *Update all*, et *ignorer cette version* quand la notif devient insistante
+- **Désinstallation** avec un vrai dialogue de confirmation, jamais un clic de trop
+- **Raccourcis bureau** pour les outils que vous utilisez tous les jours
+- **Panneau de détail** : description, page d'accueil, binaires exposés, emplacement d'installation
+- **Mode tray** : fermez la fenêtre, RunBay continue de scanner discrètement et vous prévient quand quelque chose peut être mis à jour
+- **Thèmes clair et sombre**, barre latérale repliable, recherche instantanée, couleurs par source
+
+## 🔄 RunBay se met à jour tout seul
+
+Quand une nouvelle version arrive sur npm, un point jaune apparaît dans l'app. Un clic : réinstallation et relance automatiques. Plus besoin de penser à `npm update -g`.
+
+## 📦 Sources supportées
+
+| Source | Détection | Lancement | Désinstallation | Mise à jour |
+|---|---|---|---|---|
+| npm (global) | ✅ | ✅ | ✅ | ✅ |
+| pnpm (global) | ✅ | ✅ | ✅ | ✅ |
+| yarn v1 (global) | ✅ | ✅ | ✅ | ✅ |
+| bun (global) | ✅ | ✅ | ✅ | ✅ |
+| scoop | ✅ | ✅ | ✅ | ✅ |
+
+## ⚙️ Installation
+
+> **Prérequis : [Node.js](https://nodejs.org) doit être installé** (version LTS recommandée). C'est indispensable — sans Node.js, RunBay ne peut ni s'installer ni se lancer.
+
+RunBay se distribue via npm (pas d'installeur, pas de SmartScreen) :
+
+```bash
+npm install -g runbay
+runbay
+```
+
+Ou pour essayer une seule fois, sans rien installer :
+
+```bash
+npx runbay
+```
+
+## 🔧 L'usage au quotidien
+
+Sélectionnez une app pour ouvrir son détail — version, source, emplacement, binaires exposés — puis lancez, créez un raccourci, désinstallez.
+
+![Panneau de détail](assets/screenshots/detail.png)
+
+Le clic droit ouvre un menu classé par intention : *Run*, *Manage*.
+
+![Menu contextuel](assets/screenshots/context.png)
+
+Le bouton **Options** regroupe les réglages : thème, démarrage, tray, guide de bienvenue — et la mise à jour de RunBay lui-même.
+
+![Menu Options](assets/screenshots/options.png)
+
+## 🧩 Pourquoi « pas un installateur »
+
+Un installateur ajoute des choses à votre machine. Un lanceur vous *amène* à ce que vous avez déjà. RunBay n'installe jamais rien à votre place — il lit ce que npm, pnpm, yarn, bun et scoop savent déjà, et transforme cette liste en un endroit où l'on peut travailler : lancer, mettre à jour, retirer, créer un raccourci. La ligne de commande reste votre outil d'installation ; RunBay est votre outil de lancement.
+
+## 👨‍💻 Développement
+
+```bash
+npm install
+npm run dev          # l'app avec rechargement à chaud
+npm run typecheck    # vérification des types
+npm run build        # bundles de production
+npm run package:win  # installeur Windows (electron-builder)
+```
+
+Chaque source est un **provider** isolé (`src/main/providers/`) : ajouter une nouvelle source = un seul fichier implémentant l'interface `Provider`.
+
+## ☕ Support
+
+[Buy Me a Coffee — skroproduction](https://buymeacoffee.com/skroproduction)
+
+## License
+
+MIT

package/bin/runbay.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+'use strict'
+// Lanceur RunBay (npm install -g runbay, npx runbay) : démarre l'app Electron
+// embarquée dans ce paquet, puis rend la main au terminal.
+const { spawn } = require('node:child_process')
+const { join } = require('node:path')
+
+// require('electron') renvoie le chemin du binaire Electron installé avec le paquet.
+const child = spawn(require('electron'), [join(__dirname, '..')], {
+  detached: true,
+  stdio: 'ignore',
+  windowsHide: true
+})
+child.unref()