Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Brewstrap 🚀

Your instant development environment for macOS

About

Brewstrap is a comprehensive shell script that automatically sets up a complete development environment on macOS using Homebrew. It installs essential development tools, IDEs, frameworks, and utilities to get you up and running quickly.

Quick Start

Run this command in your terminal to get started:

curl -fsSL https://raw.githubusercontent.com/Hashim1999164/Brewstrap/main/brewstrap.sh | bash

Or download and run manually:

git clone https://github.com/Hashim1999164/Brewstrap.git
cd Brewstrap
chmod +x brewstrap.sh
./brewstrap.sh

What Brewstrap Installs

🍺 Homebrew

  • Automatically installs Homebrew if not present
  • Updates Homebrew to latest version

🌐 Browsers & Communication

  • Google Chrome - Web browser
  • Microsoft Teams - Video conferencing
  • Slack - Team communication
  • Zoom - Video meetings

💻 Development IDEs & Editors

  • Cursor AI - AI-powered code editor
  • Visual Studio Code - Popular code editor
  • Visual Studio - Cross-platform development IDE
  • Android Studio - Android development
  • SourceTree - Git GUI client
  • GitHub Desktop - Git GUI client

🛠️ Development Tools & Frameworks

  • Git - Version control system
  • Node.js & npm - JavaScript runtime and package manager
  • Python - Programming language
  • Java (OpenJDK) - Java development kit
  • Kotlin - Programming language
  • Flutter - Cross-platform mobile development
  • React - JavaScript library (via create-react-app)
  • CocoaPods - iOS dependency manager
  • Gradle - Build automation tool

🐳 DevOps & Database Tools

  • Docker - Containerization platform
  • MongoDB - NoSQL database
  • Heroku CLI - Cloud platform CLI
  • Vagrant - Virtual environment management
  • Postman - API testing tool

📥 Utilities

  • Free Download Manager - Download accelerator
  • GitHub Desktop - Git GUI client

Prerequisites

  • macOS (tested on macOS 10.15+)
  • Internet connection
  • Administrator privileges (for installing packages)

Features

  • Automatic Homebrew Installation - Installs Homebrew if not present
  • Comprehensive Tool Set - Covers web, mobile, and backend development
  • One-Command Setup - Single script execution
  • Error Handling - Continues installation even if some packages fail
  • Progress Feedback - Clear installation status messages

Installation Process

  1. The script first checks if Homebrew is installed
  2. If not found, it automatically installs Homebrew
  3. Updates Homebrew to ensure latest package versions
  4. Installs all development tools and applications
  5. Provides completion confirmation

Contributing

Contributions are welcome! Here's how you can contribute:

  1. Fork the repository - Click the "Fork" button on GitHub
  2. Create a feature branch - git checkout -b feature/amazing-feature
  3. Make your changes - Add new tools, improve existing ones, or fix bugs
  4. Commit your changes - git commit -m 'Add some amazing feature'
  5. Push to the branch - git push origin feature/amazing-feature
  6. Open a Pull Request - Describe your changes and why they're beneficial

Ideas for Contributions

  • Add new development tools and frameworks
  • Improve error handling and user feedback
  • Add support for different development workflows
  • Create tool categories or modular installation options
  • Add validation for successful installations
  • Improve documentation and examples

Forking

This project is open source and encourages forking! Feel free to:

  • Fork this repository to create your own version
  • Customize the tool selection for your specific needs
  • Share your customized version with others
  • Contribute improvements back to the main repository

Support

If you encounter any issues or have questions:

  1. Check the Issues page
  2. Create a new issue with detailed information about your problem
  3. Include your macOS version and any error messages

Roadmap

  • Add support for different development profiles (web, mobile, data science)
  • Implement selective installation options
  • Add support for Linux and Windows
  • Create a GUI version
  • Add configuration file support

Made with ❤️ for the developer community

About

Your instant development environment for macOS

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages