TuxMate

![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black) ![Website](https://img.shields.io/website?url=https://tuxmate.abusov.com&style=for-the-badge) ![Maintained](https://img.shields.io/badge/Maintained-Yes-green?style=for-the-badge) [![GitHub issues](https://img.shields.io/github/issues/abusoww/tuxmate?color=red&style=for-the-badge)](https://github.com/abusoww/tuxmate/issues) [![GitHub stars](https://img.shields.io/github/stars/abusoww/tuxmate?color=green&style=for-the-badge)](https://github.com/abusoww/tuxmate/stargazers) [![GitHub license](https://img.shields.io/github/license/abusoww/tuxmate?color=yellow&style=for-the-badge)](https://github.com/abusoww/tuxmate/blob/main/LICENSE)
## 🐧 The only Mate you need for setup **TuxMate** is a web-based Linux application installer that generates distro-specific shell scripts, that aims to be the simplest way to bulk-install applications on a fresh Linux system. Maybe you've just installed a fresh Linux distro. Perhaps you're setting up a new machine or can't remember all the package names for your favorite apps? ## πŸ“¦ Supported Distributions - Ubuntu / Debian (apt) - Arch Linux (pacman + AUR via yay) - Fedora (dnf) - openSUSE (zypper) - Nix (nix-env) - Flatpak - Snap ## ✨ Features 🌟 ### **Application Catalog** 150+ applications across 15 categories: browsers, communication, dev tools, terminals, media, creative software, gaming, office, VPN/network, security, and more. ### **Smart Script Generation** - Detects already-installed packages - Handles AUR packages automatically on Arch - Enables RPM Fusion when needed on Fedora - Parallel installation for Flatpak - Network retry with exponential backoff - Progress bars with ETA - Colored output and summary reports ### **Availability Awareness** Shows which apps are available for your selected distro, with instructions for unavailable packages. ## πŸ“Έ Screenshots ![Main interface with app selection](src/screenshots/1.png) ![Category browsing and filtering](src/screenshots/2.png) ![Generated install script](src/screenshots/3.png)

πŸ’» Development

 ```bash npm install npm run dev ``` Open [http://localhost:3000](http://localhost:3000) ### Build ```bash npm run build npm start ```

πŸ—‚οΈ Project Structure

 ``` src/ β”œβ”€β”€ app/ # Next.js app router β”‚ β”œβ”€β”€ page.tsx # Main page component β”‚ β”œβ”€β”€ layout.tsx # Root layout with meta tags β”‚ └── globals.css # Tailwind styles β”œβ”€β”€ components/ β”‚ β”œβ”€β”€ app/ # App cards & categories β”‚ β”œβ”€β”€ command/ # Command footer & AUR bar β”‚ β”œβ”€β”€ common/ # Tooltips, loading states β”‚ β”œβ”€β”€ distro/ # Distribution selector β”‚ β”œβ”€β”€ header/ # Header & theme toggle β”‚ └── ui/ # Base UI components β”œβ”€β”€ hooks/ # React hooks β”‚ β”œβ”€β”€ useLinuxInit.ts # Main app state management β”‚ β”œβ”€β”€ useKeyboardNavigation.ts β”‚ β”œβ”€β”€ useTheme.ts β”‚ └── useDelayedTooltip.ts β”œβ”€β”€ lib/ β”‚ β”œβ”€β”€ data.ts # Apps, distros, icons β”‚ β”œβ”€β”€ aur.ts # AUR package detection β”‚ β”œβ”€β”€ analytics.ts # Umami tracking β”‚ β”œβ”€β”€ generateInstallScript.ts β”‚ └── scripts/ # Per-distro script generators └── __tests__/ # Vitest unit tests ```

🐳 Docker Deployment

 ### Quick Start with Docker ```bash # Build the Docker image docker build -t tuxmate:latest . # Run the container docker run -p 3000:3000 tuxmate:latest ``` ### Using Pre-built Images Pre-built Docker images are automatically published to GitHub Container Registry: ```bash # Pull and run the latest image docker pull ghcr.io/abusoww/tuxmate:latest docker run -p 3000:3000 ghcr.io/abusoww/tuxmate:latest # Or use a specific version docker pull ghcr.io/abusoww/tuxmate:v1.0.0 docker run -p 3000:3000 ghcr.io/abusoww/tuxmate:v1.0.0 ``` ### Using Docker Compose (Recommended) ```bash # Start the application docker-compose up -d # View logs docker-compose logs -f # Stop the application docker-compose down ``` Open [http://localhost:3000](http://localhost:3000) ### Configuration The Docker container exposes port 3000 by default. You can customize the port mapping: ```bash docker run -p 8080:3000 tuxmate:latest ``` ### Environment Variables The following environment variables are configured by default: - `NODE_ENV=production` - Run in production mode - `PORT=3000` - Application port - `NEXT_TELEMETRY_DISABLED=1` - Disable Next.js anonymous telemetry You can override these when running the container: ```bash docker run -p 3000:3000 \ -e PORT=3000 \ -e NEXT_TELEMETRY_DISABLED=1 \ tuxmate:latest ```
## πŸ› οΈ Tech Stack - [Next.js](https://nextjs.org/) 16 (App Router) - [React](https://react.dev/) 19 - [TypeScript](https://www.typescriptlang.org/) - [Tailwind CSS](https://tailwindcss.com/) 4 - [Framer Motion](https://www.framer.com/motion/) - [GSAP](https://gsap.com/) - [Vitest](https://vitest.dev/) (testing) - [Lucide React](https://lucide.dev/) (icons) ## πŸš€ Usage you can use the Arrow Keys orΒ `h`Β `j`Β `k`Β `l`Β to navigate,Β `Enter` to select, `Esc` to go back, `Space` to toggle selection. 1. Select your distribution from the dropdown 2. Browse categories and select applications 3. Copy the generated command or download the full install script 4. Run the script on your Linux machine ## 🀝 Contribution See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines. ## 🎯 Roadmap ### Completed - [x] Multi-distro support (Ubuntu, Debian, Arch, Fedora, openSUSE) - [x] Nix, Flatpak & Snap universal package support - [x] 150+ applications across 15 categories - [x] Smart script generation with error handling - [x] AUR helper integration (yay) for Arch - [x] Keyboard navigation (Vim keys + Arrows) - [x] Dark / Light theme toggle - [x] Copy command & Download script - [x] Package availability indicators - [x] Custom domain - [x] Docker support for containerized deployment - [x] CI/CD workflow for automated Docker builds ### Planned - [ ] Search & filter applications - [ ] Winget support (Windows) - [ ] Homebrew support (macOS) - [ ] Save custom presets / profiles - [ ] Share configurations via URL - [ ] More distros (Gentoo, Void, Alpine) - [ ] PWA support for offline use - [ ] Companion CLI tool - [ ] Expand application catalog (200+) - [ ] Dotfiles integration
## πŸ“œ License Licensed under the [GPL-3.0 License](LICENSE)
Free software β€” you can redistribute and modify it under the terms of the GNU General Public License.