Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

61 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

HatStart Logo

HatStart

One-click developer environment setup for Windows, macOS, and Linux

TypeScript Electron React License

πŸš€ What is HatStart?

HatStart is an open-source, cross-platform developer toolkit installer that sets up your complete development environment with one click. No more following lengthy setup guides or debugging installation issues - HatStart handles everything for you.

✨ Key Features

  • πŸ–±οΈ One-Click Installation: Set up your entire development environment in minutes
  • 🎯 Job Role Recommendations: Get tool suggestions based on your role (Full-Stack, DevOps, Data Science, etc.)
  • πŸ“¦ Version Management: Automatically manage multiple versions of languages (Node.js, Python, Ruby, etc.)
  • πŸ”§ IDE Configuration: Auto-configure VS Code, Cursor, or JetBrains with extensions and settings
  • 🌍 Cross-Platform: Works seamlessly on Windows, macOS, and Linux
  • πŸ“š Extensible: Easy to add new tools via YAML/JSON manifests - no coding required!
  • 🚫 Offline-First: No cloud dependencies for core functionality

πŸ“Š Project Status

Current Version: Development (Pre-release)
Progress: 13 of 25 planned features complete (52%)

Recently Completed βœ…

  • Conflict Resolution UI (MVP - warns about tool conflicts)
  • Tool Installation Detection (shows installed status & versions)
  • Version Management System (Mise, NVM, PyEnv, ASDF, RBenv)
  • IDE Workspace Generation (VS Code/Cursor configuration)
  • Job Role Assessment System
  • Cross-platform Installer Framework
  • MVP Simplification (removed 49,000+ lines of over-engineered code)
  • Expanded Tool Catalog (63 tools across 6 categories)

In Progress πŸ”„

  • Real-time Progress Tracking
  • Platform-specific Enhancements

View Full Roadmap β†’

🎯 Who is HatStart For?

  • New Developers: Get started quickly without setup headaches
  • Experienced Developers: Standardize your environment across machines
  • Teams: Share consistent development setups
  • Companies: Onboard developers faster with custom configurations

πŸš€ Quick Start

Using HatStart

  1. Download the latest release for your platform
  2. Run HatStart
  3. Choose your developer role (optional)
  4. Select tools to install
  5. Click "Install" and grab a coffee β˜•

Example: Full-Stack Developer Setup

HatStart can set up a complete full-stack environment including:

  • Node.js (via NVM) with version management
  • Python (via PyEnv) with virtual environments
  • Git with proper configuration
  • Docker Desktop
  • VS Code with relevant extensions
  • PostgreSQL and Redis
  • All configured and ready to use!

πŸ“¦ Available Tools (63 total)

IDEs (2): VS Code, Cursor

Languages (7): Node.js, Python, Go, Rust, Java, Ruby, PHP

Frameworks (13): React, Vue.js, Angular, Next.js, Nuxt.js, SvelteKit, NestJS, Django, FastAPI, Flask, Laravel, Rails, Tailwind CSS, PostCSS

Databases (5): PostgreSQL, MySQL, MongoDB, Redis, SQLite

DevOps & Infrastructure (26):

  • Containers: Docker, Podman, Kubernetes, Minikube
  • Cloud CLIs: AWS CLI, Azure CLI, Google Cloud SDK
  • HashiCorp: Terraform, Vault, Packer, Consul, Nomad
  • CI/CD: Helm, Ansible
  • Testing: Vitest, Jest, Playwright, Cypress, K6
  • Monitoring: Prometheus, Grafana
  • Security: Semgrep, Bandit, Checkov, SOPS, age

Productivity & Build Tools (10): Git, GitHub CLI, Postman, Insomnia, HTTPie, Gradle, Maven, Yarn, pnpm, Composer

🀝 Contributing

We love contributions! HatStart is designed to be easily extensible.

Add a New Tool (No Coding!)

  1. Create a manifest file:
id: "terraform"
name: "Terraform"
category: "Infrastructure"
platforms:
  windows:
    installer: "chocolatey"
    package: "terraform"
  macos:
    installer: "homebrew"
    package: "terraform"
  linux:
    installer: "apt"
    package: "terraform"
  1. Submit a PR - that's it!

Read Contributing Guide β†’

πŸ—οΈ Architecture

HatStart is built with modern web technologies:

  • Frontend: React 19 + TypeScript + Tailwind CSS
  • Backend: Electron 36 with secure IPC
  • Build: Vite + ESLint
  • Testing: Vitest with comprehensive coverage

Key Systems

  1. Simple Manifest System: Define tools in JSON (~230 lines)
  2. Simple Tool Installer: Direct package manager wrapper (~400 lines)
  3. Version Management: Universal version manager support
  4. Job Role Recommendations: Rule-based tool suggestions
  5. IDE Workspace Generation: Simple config file generation (~460 lines)

πŸ“– Documentation

πŸ› οΈ Development

# Clone the repository
git clone https://github.com/yourusername/hatstart.git
cd hatstart

# Install dependencies
npm install

# Run development server
npm run dev

# Run tests
npm test

# Build for production
npm run build

πŸ“œ License

HatStart is MIT licensed. See LICENSE for details.

πŸ™ Acknowledgments

Built with ❀️ by developers, for developers. Special thanks to all contributors!


Note: HatStart is in active development. Star ⭐ the repo to follow our progress!

About

HatStart - The Automated Developer Toolkit Installer

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages