https://github.com/josepharunjoseph/bleuprint
Bootstrap your Mac development environment with bleuprint. This Nix-Darwin template includes 120+ tools for a modern setup. 🌟💻
https://github.com/josepharunjoseph/bleuprint
chat cli-tools configuration-management darwin developer-tools development-environment dotfiles-template mac-bootstrap macos macos-setup modern-unix nix nix-darwin nix-flakes rust-tools tutorial tutorials whois-client
Last synced: 3 months ago
JSON representation
Bootstrap your Mac development environment with bleuprint. This Nix-Darwin template includes 120+ tools for a modern setup. 🌟💻
- Host: GitHub
- URL: https://github.com/josepharunjoseph/bleuprint
- Owner: josepharunjoseph
- License: mit
- Created: 2025-06-26T13:54:14.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-06-26T17:21:51.000Z (3 months ago)
- Last Synced: 2025-06-26T18:31:00.402Z (3 months ago)
- Topics: chat, cli-tools, configuration-management, darwin, developer-tools, development-environment, dotfiles-template, mac-bootstrap, macos, macos-setup, modern-unix, nix, nix-darwin, nix-flakes, rust-tools, tutorial, tutorials, whois-client
- Language: Shell
- Homepage: https://josepharunjoseph.github.io
- Size: 3.66 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
- Security: docs/SECURITY.md
Awesome Lists containing this project
README
# Bleuprint: Modern Mac Development Environment Template 🚀
[](https://github.com/josepharunjoseph/bleuprint/releases)
## Overview
Bleuprint is a modern template for setting up a Mac development environment. It leverages Nix-Darwin to provide a secure, reproducible setup. With over 120 tools, it allows developers to bootstrap their environment with a single command.
## Features
- **Security-First Approach**: Prioritize security in your development setup.
- **Reproducible Environment**: Easily replicate your setup across machines.
- **One-Command Setup**: Quickly bootstrap your development environment.
- **Extensive Tooling**: Access to 120+ tools tailored for Mac development.
## Getting Started
### Prerequisites
Before you begin, ensure you have the following:
- A Mac running macOS.
- Basic knowledge of the terminal.
- Homebrew installed (optional but recommended).
### Installation
To set up your environment, follow these steps:
1. **Clone the Repository**:
```bash
git clone https://github.com/josepharunjoseph/bleuprint.git
cd bleuprint
```
2. **Run the Setup Script**:
Download the latest release from the [Releases section](https://github.com/josepharunjoseph/bleuprint/releases) and execute the script:
```bash
./setup.sh
```
3. **Configuration**:
Adjust the configuration files as needed. Refer to the `docs` folder for detailed instructions.
## Tools Included
Bleuprint comes with a comprehensive set of tools for various development needs. Here are some categories:
### CLI Tools
- **Git**: Version control system.
- **Node.js**: JavaScript runtime for server-side development.
- **Python**: Programming language for various applications.
### Rust Tools
- **Cargo**: Rust package manager and build system.
- **Rust Analyzer**: Language server for Rust.
### Development Environment
- **Nix**: Package manager for reproducible builds.
- **Homebrew**: Package manager for macOS.
## Configuration Management
Bleuprint uses Nix-Darwin for configuration management. This allows you to define your environment declaratively. You can find the configuration files in the `nix` directory.
### Customization
Feel free to customize the `configuration.nix` file to add or remove tools according to your needs.
## Topics Covered
This repository covers a wide range of topics, including:
- **CLI Tools**: Command-line utilities to enhance productivity.
- **Configuration Management**: Manage your environment with ease.
- **Darwin**: macOS-specific configurations.
- **Development Environment**: Set up a robust development space.
- **Dotfiles Template**: Manage your dotfiles effectively.
- **Nix Flakes**: Use Nix flakes for reproducible builds.
## Contributing
We welcome contributions! To get started:
1. Fork the repository.
2. Create a new branch.
3. Make your changes.
4. Submit a pull request.
Please ensure your code follows the project's coding standards.
## License
This project is licensed under the MIT License. See the `LICENSE` file for details.
## Support
If you encounter any issues, please check the [Issues section](https://github.com/josepharunjoseph/bleuprint/issues) for existing discussions or create a new issue.
## Links
For more information, visit the [Releases section](https://github.com/josepharunjoseph/bleuprint/releases) to download the latest version and access the setup script.
## Acknowledgments
Thanks to the contributors of Nix and Nix-Darwin for their excellent work in creating a robust environment management system.
## Additional Resources
- [Nix Documentation](https://nixos.org/manual/nix/stable/)
- [Nix-Darwin GitHub](https://github.com/LnL7/nix-darwin)
## Images
## FAQs
### How do I update my environment?
To update your environment, simply pull the latest changes from the repository and rerun the setup script.
### Can I use Bleuprint on other operating systems?
Bleuprint is designed specifically for macOS. While some components may work on other systems, full functionality is not guaranteed.
### What if I need help?
For help, please open an issue in the repository or reach out through our community channels.
### How do I uninstall Bleuprint?
To uninstall, simply remove the files created during the setup. Refer to the `uninstall.sh` script for a complete removal process.
## Community
Join our community on Discord or follow us on Twitter for updates and discussions.
- [Discord Channel](https://discord.gg/yourchannel)
- [Twitter](https://twitter.com/yourprofile)
## Final Note
Bleuprint aims to simplify the Mac development setup process while maintaining a focus on security and reproducibility. We hope you find it useful in your development journey.
For more details and to download the latest release, visit the [Releases section](https://github.com/josepharunjoseph/bleuprint/releases).