From e81beacdea5cd700ff6ac9bfd6a83d7c92c581a4 Mon Sep 17 00:00:00 2001 From: Vito Castellano Date: Sat, 29 Mar 2025 16:53:21 +0100 Subject: [PATCH] add blog --- docs/blog/essential-homebrew-commands.html | 163 ++++++++++++ docs/blog/index.html | 147 +++++++++++ docs/blog/install-homebrew-macos.html | 170 ++++++++++++ docs/blog/managing-homebrew-packages.html | 158 +++++++++++ docs/index.html | 285 +++++++++++++------- docs/manifest.json | 61 +++++ docs/robots.txt | 8 + docs/sitemap.xml | 56 +++- docs/styles.css | 292 +++++++++++++++++++++ 9 files changed, 1236 insertions(+), 104 deletions(-) create mode 100644 docs/blog/essential-homebrew-commands.html create mode 100644 docs/blog/index.html create mode 100644 docs/blog/install-homebrew-macos.html create mode 100644 docs/blog/managing-homebrew-packages.html create mode 100644 docs/manifest.json diff --git a/docs/blog/essential-homebrew-commands.html b/docs/blog/essential-homebrew-commands.html new file mode 100644 index 0000000..977c3a5 --- /dev/null +++ b/docs/blog/essential-homebrew-commands.html @@ -0,0 +1,163 @@ + + + + + + 10 Essential Homebrew Commands You Should Know | Bold Brew Blog + + + + + + + + + + + + + +
+ +
+ +
+
+
+

10 Essential Homebrew Commands You Should Know

+
+ March 29, 2024 + By Valkyrie00 +
+
+ +
+

Homebrew is a powerful package manager for macOS, but its command-line interface can be overwhelming. In this guide, we'll cover the 10 most essential Homebrew commands that every macOS user should know.

+ +

1. Package Installation

+
brew install package_name
+

This is the most basic and commonly used command. For example:

+
brew install git
+

You can also install multiple packages at once:

+
brew install git node python
+ +

2. Package Updates

+
brew update
+

Updates Homebrew's package database. Always run this before installing new packages or upgrading existing ones.

+ +

3. Upgrade Packages

+
brew upgrade
+

Upgrades all installed packages to their latest versions. To upgrade a specific package:

+
brew upgrade package_name
+ +

4. Package Removal

+
brew uninstall package_name
+

Removes a package from your system. For example:

+
brew uninstall git
+ +

5. Package Information

+
brew info package_name
+

Shows detailed information about a package, including its dependencies and installation status.

+ +

6. List Installed Packages

+
brew list
+

Shows all packages currently installed on your system.

+ +

7. Search for Packages

+
brew search package_name
+

Searches for packages in the Homebrew repository. For example:

+
brew search python
+ +

8. System Check

+
brew doctor
+

Diagnoses your Homebrew installation and suggests fixes for common issues.

+ +

9. Clean Up

+
brew cleanup
+

Removes old versions of installed packages and cleans up the Homebrew cache.

+ +

10. Tap Management

+
brew tap
+

Lists all tapped repositories. To add a new tap:

+
brew tap user/repo
+ +

Making Command Management Easier with Bold Brew

+

While these commands are powerful, remembering them all can be challenging. That's where Bold Brew comes in. It provides a visual interface for all these operations:

+
brew install Valkyrie00/homebrew-bbrew/bbrew
+

With Bold Brew, you can:

+
    +
  • Search and install packages with a visual interface
  • +
  • Update packages with a few clicks
  • +
  • View package information in a structured format
  • +
  • Manage dependencies visually
  • +
+ +

Pro Tips

+
    +
  • Use brew update && brew upgrade to update everything at once
  • +
  • Combine brew cleanup with upgrades to keep your system clean
  • +
  • Use brew doctor regularly to maintain a healthy Homebrew installation
  • +
+ +
+

Want to make package management even easier? Try Bold Brew:

+
brew install Valkyrie00/homebrew-bbrew/bbrew
+
+ + +
+ +
+
+ Homebrew + macOS + Command Line + Development Tools +
+
+
+
+ + + + + + \ No newline at end of file diff --git a/docs/blog/index.html b/docs/blog/index.html new file mode 100644 index 0000000..b538bae --- /dev/null +++ b/docs/blog/index.html @@ -0,0 +1,147 @@ + + + + + + Bold Brew Blog - Homebrew Tips, Tutorials & Guides + + + + + + + + + + + + + +
+ +
+ +
+
+

Bold Brew Blog

+

Tips, tutorials, and guides for managing Homebrew packages on macOS

+
+ +
+
+
+ + + + + +
+
+ + +
+
+ + + + + + \ No newline at end of file diff --git a/docs/blog/install-homebrew-macos.html b/docs/blog/install-homebrew-macos.html new file mode 100644 index 0000000..df8c79c --- /dev/null +++ b/docs/blog/install-homebrew-macos.html @@ -0,0 +1,170 @@ + + + + + + How to Install and Configure Homebrew on macOS | Bold Brew Blog + + + + + + + + + + + + + +
+ +
+ +
+
+
+

How to Install and Configure Homebrew on macOS

+
+ March 29, 2024 + By Valkyrie00 +
+
+ +
+

Homebrew is the most popular package manager for macOS, making it easy to install and manage software packages. In this comprehensive guide, we'll walk you through the installation process and show you how to configure it properly.

+ +

Prerequisites

+

Before installing Homebrew, make sure you have:

+
    +
  • macOS 10.15 Catalina or newer
  • +
  • Command Line Tools for Xcode installed
  • +
  • Administrator access to your Mac
  • +
+ +

Installing Command Line Tools

+

First, install the Command Line Tools by running:

+
xcode-select --install
+

A popup window will appear asking you to confirm the installation. Click "Install" and wait for the process to complete.

+ +

Installing Homebrew

+

Now, let's install Homebrew. Open Terminal and run:

+
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+

This command will:

+
    +
  1. Download the Homebrew installation script
  2. +
  3. Install Homebrew in the recommended location
  4. +
  5. Set up the necessary directories and permissions
  6. +
+ +

Configuring Homebrew

+

After installation, you need to add Homebrew to your PATH. Run these commands:

+
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
+eval "$(/opt/homebrew/bin/brew shellenv)"
+ +

Verifying the Installation

+

To verify that Homebrew is installed correctly, run:

+
brew --version
+

You should see the Homebrew version number. Also, run:

+
brew doctor
+

This command will check your system for potential problems and provide recommendations.

+ +

Updating Homebrew

+

It's important to keep Homebrew up to date. Run:

+
brew update
+ +

Installing Your First Package

+

Now that Homebrew is installed, you can install packages. For example, to install Git:

+
brew install git
+ +

Using Bold Brew for Package Management

+

While Homebrew's command-line interface is powerful, managing packages can be more intuitive with a Terminal User Interface (TUI). That's where Bold Brew comes in:

+
brew install Valkyrie00/homebrew-bbrew/bbrew
+

Bold Brew provides a visual interface for managing your Homebrew packages, making it easier to:

+
    +
  • Search for packages
  • +
  • Install and remove packages
  • +
  • Update packages
  • +
  • Manage dependencies
  • +
+ +

Common Issues and Solutions

+

Permission Issues

+

If you encounter permission issues, run:

+
sudo chown -R $(whoami) /usr/local/*
+ +

Update Failures

+

If updates fail, try:

+
brew update-reset
+ +

Next Steps

+

Now that you have Homebrew installed, you can:

+
    +
  • Install development tools
  • +
  • Set up your development environment
  • +
  • Install productivity applications
  • +
  • Manage system utilities
  • +
+ +
+

Want to make package management even easier? Try Bold Brew:

+
brew install Valkyrie00/homebrew-bbrew/bbrew
+
+ + +
+ +
+
+ Homebrew + macOS + Installation + Development Tools +
+
+
+
+ + + + + + \ No newline at end of file diff --git a/docs/blog/managing-homebrew-packages.html b/docs/blog/managing-homebrew-packages.html new file mode 100644 index 0000000..8c4dd4c --- /dev/null +++ b/docs/blog/managing-homebrew-packages.html @@ -0,0 +1,158 @@ + + + + + + Managing Homebrew Packages on macOS: A Complete Guide | Bold Brew Blog + + + + + + + + + + + + + +
+ +
+ +
+
+
+

Managing Homebrew Packages on macOS: A Complete Guide

+
+ March 29, 2024 + By Valkyrie00 +
+
+ +
+

Homebrew is the de facto package manager for macOS, but managing packages through the command line can be challenging. In this guide, we'll explore how Bold Brew (bbrew) can simplify your package management workflow.

+ +

Why Use a TUI for Homebrew?

+

While Homebrew's command-line interface is powerful, it can be overwhelming for many users. A Terminal User Interface (TUI) like Bold Brew provides several advantages:

+
    +
  • Visual package management
  • +
  • Intuitive navigation
  • +
  • Quick access to common operations
  • +
  • Better overview of installed packages
  • +
+ +

Getting Started with Bold Brew

+

Installing Bold Brew is straightforward:

+
brew install Valkyrie00/homebrew-bbrew/bbrew
+

Once installed, simply run:

+
bbrew
+ +

Key Features for Package Management

+

1. Package Installation

+

With Bold Brew, installing packages becomes a visual experience. You can:

+
    +
  • Search for packages in real-time
  • +
  • View package details before installation
  • +
  • Install multiple packages at once
  • +
  • See installation progress visually
  • +
+ +

2. Package Updates

+

Keeping your packages up to date is crucial for security and functionality. Bold Brew makes this process simple:

+
    +
  • View all outdated packages at a glance
  • +
  • Select which packages to update
  • +
  • Monitor update progress
  • +
  • Handle update failures gracefully
  • +
+ +

3. Dependency Management

+

Package dependencies can be complex. Bold Brew helps you:

+
    +
  • Visualize package relationships
  • +
  • Identify orphaned dependencies
  • +
  • Clean up unused packages
  • +
  • Resolve dependency conflicts
  • +
+ +

Best Practices

+

To get the most out of Bold Brew and Homebrew, follow these best practices:

+
    +
  1. Regularly update your packages
  2. +
  3. Clean up unused dependencies
  4. +
  5. Back up your Homebrew configuration
  6. +
  7. Use the search feature before installing new packages
  8. +
+ +

Common Issues and Solutions

+

Even with a TUI, you might encounter some common issues:

+
    +
  • Permission issues: Use sudo chown -R $(whoami) /usr/local/*
  • +
  • Update failures: Try brew update-reset
  • +
  • Broken dependencies: Use brew doctor
  • +
+ +

Conclusion

+

Bold Brew transforms the way you manage Homebrew packages on macOS. By providing a visual interface to package management, it makes the process more intuitive and efficient. Whether you're a seasoned developer or new to macOS, Bold Brew can help you manage your packages more effectively.

+ +
+

Ready to try Bold Brew? Install it now with:

+
brew install Valkyrie00/homebrew-bbrew/bbrew
+
+
+ +
+
+ Homebrew + macOS + Package Management + Development Tools +
+ +
+
+
+ + + + + + \ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 29e3a41..c309da1 100644 --- a/docs/index.html +++ b/docs/index.html @@ -3,33 +3,63 @@ - Bold Brew - Homebrew TUI Manager - - + Bold Brew (bbrew) - Modern Homebrew TUI Manager for macOS + + - + + - - + + + - - + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + - + + +
+ +
+
-
+
- Bold Brew Logo + Bold Brew Logo

Bold Brew

bbrew

A fast and practical TUI that simplifies your Homebrew package management on macOS, making installations and updates effortless

- Version - License - Build Status - Downloads + Version + License + Build Status + Downloads
-
+

Installation

Get started with Bold Brew in just a few simple commands

@@ -89,11 +162,11 @@
1
-
Install Bold Brew
+

Install Bold Brew

> brew install Valkyrie00/homebrew-bbrew/bbrew
- @@ -104,11 +177,11 @@
2
-
Run Bold Brew
+

Run Bold Brew

> bbrew
- @@ -122,7 +195,7 @@

Download the latest version directly from GitHub

- + Download Latest Release @@ -133,98 +206,111 @@
-
+

Screenshots

Explore the Bold Brew interface and its features

-
- Main Dashboard -
+
+ Main Dashboard showing package management interface +

Main Dashboard

-
-
+ +
-
- Handle Installed Packages -
+
+ Installed packages management view +

Handle Installed Packages

-
-
+ +
-
- Search for Packages -
+
+ Package search interface +

Search for Packages

-
-
+ +
-
+
-

Features

-

Discover what makes Bold Brew the perfect tool for managing your Homebrew packages

- -
-
+

Features

+
+
-
- ⚙️ -
-

Install & Remove

-

Easily install new packages or remove existing ones with a simple, intuitive interface

-
-
- -
-
-
- 🔍 -
+

Search Packages

-

Quickly find and explore new packages available in the Homebrew ecosystem

+

Easily search and find Homebrew packages with our intuitive interface.

- -
+
-
- -
-

Update Packages

-

Keep your packages up to date with visual update management and notifications

+ +

Install & Update

+

Install, update, and manage packages with just a few clicks.

- -
+
-
- 🔄 -
-

Manage Dependencies

-

View and handle package dependencies with a clear visual representation

-
-
-
- -
-
-
-

Bold Brew provides a modern and intuitive TUI (Text User Interface) for Homebrew, making package management on macOS more efficient than ever before.

+ +

System Management

+

Monitor system status and manage Homebrew services efficiently.

-
+
+
+

Latest Articles

+
+
+
+ +

10 Essential Homebrew Commands

+

Master the most important Homebrew commands for macOS package management.

+ Read more → +
+
+
+
+ +

Install Homebrew on macOS

+

Learn how to install and configure Homebrew on your Mac.

+ Read more → +
+
+
+
+ +

Managing Packages with Bold Brew

+

Discover how to efficiently manage Homebrew packages using Bold Brew.

+ Read more → +
+
+
+ +
+
+ +

Manage Homebrew Packages on macOS with Bold Brew

@@ -248,8 +334,7 @@
- -
+

About Bold Brew for macOS

@@ -277,7 +362,7 @@
-
+

FAQ

Frequently asked questions about Bold Brew

@@ -286,33 +371,37 @@
-
What is Bold Brew?
+

What is Bold Brew?

+
-

It's a Text User Interface for managing Homebrew packages on macOS.

+

Bold Brew (bbrew) is a modern Terminal User Interface for managing Homebrew packages on macOS. It provides an elegant and intuitive way to install, update, and manage your Homebrew packages without memorizing complex commands.

-
How do I install Bold Brew?
+

How do I install Bold Brew?

+
-

You can install it through Homebrew or by downloading the latest release from GitHub.

+

You can install Bold Brew in two ways:

+
    +
  1. Using Homebrew: brew install Valkyrie00/homebrew-bbrew/bbrew
  2. +
  3. Downloading the latest release from our GitHub repository
  4. +
-
How do I update Bold Brew?
+

How do I update Bold Brew?

+ @@ -325,7 +414,7 @@
-
How do I remove Bold Brew?
+

How do I remove Bold Brew?

+ @@ -338,27 +427,27 @@
-
Does it work on Linux or Windows?
+

Does it work on Linux or Windows?

+
-

Currently, Bold Brew is designed for macOS since it depends on the Homebrew package manager.

+

Currently, Bold Brew is designed specifically for macOS since it depends on the Homebrew package manager, which is primarily for macOS.

-
Where can I report issues or request features?
+

Where can I report issues or request features?

+
-

Feel free to open an issue on the project's GitHub repository.

+

Feel free to open an issue on our GitHub repository.

@@ -370,7 +459,7 @@ diff --git a/docs/manifest.json b/docs/manifest.json new file mode 100644 index 0000000..ea792cb --- /dev/null +++ b/docs/manifest.json @@ -0,0 +1,61 @@ +{ + "name": "Bold Brew", + "short_name": "bbrew", + "description": "Modern Homebrew TUI Manager for macOS", + "start_url": "/", + "display": "standalone", + "background_color": "#1a1a1a", + "theme_color": "#1a1a1a", + "orientation": "portrait", + "icons": [ + { + "src": "assets/ico/bbrew-16.ico", + "sizes": "16x16", + "type": "image/x-icon" + }, + { + "src": "assets/ico/bbrew-24.ico", + "sizes": "24x24", + "type": "image/x-icon" + }, + { + "src": "assets/ico/bbrew-32.ico", + "sizes": "32x32", + "type": "image/x-icon" + }, + { + "src": "assets/ico/bbrew-48.ico", + "sizes": "48x48", + "type": "image/x-icon" + }, + { + "src": "assets/ico/bbrew-180.ico", + "sizes": "180x180", + "type": "image/x-icon" + } + ], + "categories": ["developer tools", "utilities"], + "screenshots": [ + { + "src": "assets/screenshots/bbrew-main-screenshot.png", + "sizes": "400x300", + "type": "image/png", + "platform": "macOS", + "label": "Main Dashboard" + }, + { + "src": "assets/screenshots/bbrew-installed-screenshot.png", + "sizes": "400x300", + "type": "image/png", + "platform": "macOS", + "label": "Installed Packages" + }, + { + "src": "assets/screenshots/bbrew-search-screenshot.png", + "sizes": "400x300", + "type": "image/png", + "platform": "macOS", + "label": "Package Search" + } + ] +} \ No newline at end of file diff --git a/docs/robots.txt b/docs/robots.txt index a6c1796..a480df3 100644 --- a/docs/robots.txt +++ b/docs/robots.txt @@ -1,3 +1,11 @@ User-agent: * Allow: / +Allow: /assets/ +Allow: /screenshots/ +Allow: /sitemap.xml + +Disallow: /admin/ +Disallow: /private/ +Disallow: /tmp/ + Sitemap: https://bold-brew.com/sitemap.xml \ No newline at end of file diff --git a/docs/sitemap.xml b/docs/sitemap.xml index 4222182..2f51665 100644 --- a/docs/sitemap.xml +++ b/docs/sitemap.xml @@ -1,9 +1,53 @@ - - https://bold-brew.com - 2025-03-01 - monthly - 1.0 - + + https://bold-brew.com/ + 2024-03-29 + weekly + 1.0 + + + https://bold-brew.com/blog/ + 2024-03-29 + weekly + 0.8 + + + https://bold-brew.com/blog/essential-homebrew-commands.html + 2024-03-29 + monthly + 0.7 + + + https://bold-brew.com/blog/install-homebrew-macos.html + 2024-03-29 + monthly + 0.7 + + + https://bold-brew.com/blog/managing-homebrew-packages.html + 2024-03-29 + monthly + 0.7 + + + https://bold-brew.com/#features + monthly + 0.8 + + + https://bold-brew.com/#install + monthly + 0.8 + + + https://bold-brew.com/#about + monthly + 0.7 + + + https://bold-brew.com/#faq + monthly + 0.6 + \ No newline at end of file diff --git a/docs/styles.css b/docs/styles.css index c95c0c5..f76134f 100644 --- a/docs/styles.css +++ b/docs/styles.css @@ -773,4 +773,296 @@ footer a:hover { .faq-question h5 { font-size: 1.05rem; } +} + +/* Blog Styles */ +.blog-posts { + margin-bottom: 3rem; + position: relative; +} + +.blog-posts::after { + content: ''; + position: absolute; + right: -2rem; + top: 0; + bottom: 0; + width: 1px; + background: linear-gradient(to bottom, transparent, #1E3449, transparent); +} + +.blog-post { + padding: 2rem; + background: #15202B; + border: 1px solid #1E3449; + border-radius: 8px; + transition: all 0.3s ease; + margin-bottom: 2rem; + position: relative; +} + +.blog-post:last-child { + margin-bottom: 0; +} + +.blog-post:hover { + transform: translateY(-2px); + border-color: #4EA1FF; + box-shadow: 0 5px 15px rgba(0, 0, 0, 0.3); +} + +.blog-post::after { + content: ''; + position: absolute; + bottom: -1rem; + left: 2rem; + right: 2rem; + height: 1px; + background: linear-gradient(to right, transparent, #1E3449, transparent); +} + +.blog-post:last-child::after { + display: none; +} + +.post-meta { + font-size: 0.9rem; + color: var(--text-secondary); + margin-bottom: 1rem; +} + +.post-meta .date, +.post-meta .author { + margin-right: 1rem; +} + +.blog-post h2 { + font-size: 1.8rem; + margin-bottom: 1rem; +} + +.blog-post h2 a { + color: var(--text-primary); + text-decoration: none; + transition: color 0.2s ease; +} + +.blog-post h2 a:hover { + color: var(--accent-color); +} + +.excerpt { + color: var(--text-secondary); + margin-bottom: 1.5rem; + line-height: 1.6; +} + +.tags { + display: flex; + flex-wrap: wrap; + gap: 0.5rem; + margin-bottom: 1rem; +} + +.tag { + background: var(--bg-primary); + color: var(--text-secondary); + padding: 0.25rem 0.75rem; + border-radius: 20px; + font-size: 0.9rem; + text-decoration: none; + transition: all 0.2s ease; +} + +.tag:hover { + background: var(--accent-color); + color: var(--text-primary); +} + +.read-more { + color: var(--accent-color); + text-decoration: none; + font-weight: 500; + transition: color 0.2s ease; +} + +.read-more:hover { + color: var(--accent-hover); +} + +/* Sidebar Styles */ +.sidebar { + position: sticky; + top: 2rem; + padding-left: 2rem; +} + +.widget { + background: #15202B; + border: 1px solid #1E3449; + padding: 1.5rem; + border-radius: 8px; + margin-bottom: 2rem; + transition: all 0.3s ease; +} + +.widget:hover { + border-color: #4EA1FF; + box-shadow: 0 5px 15px rgba(0, 0, 0, 0.3); +} + +.widget:last-child { + margin-bottom: 0; +} + +.widget h3 { + font-size: 1.4rem; + margin-bottom: 1rem; + color: var(--text-primary); +} + +.social-links { + display: flex; + gap: 1rem; +} + +.social-links a { + color: var(--text-secondary); + text-decoration: none; + transition: color 0.2s ease; +} + +.social-links a:hover { + color: var(--accent-color); +} + +/* Responsive Adjustments */ +@media (max-width: 992px) { + .blog-posts::after { + display: none; + } + + .sidebar { + padding-left: 0; + } +} + +@media (max-width: 768px) { + article header h1 { + font-size: 2rem; + } + + article .content { + font-size: 1rem; + } + + article .content h2 { + font-size: 1.6rem; + } + + article .content h3 { + font-size: 1.3rem; + } +} + +/* Article Page Improvements */ +article { + max-width: 800px; + margin: 0 auto; +} + +article header { + margin-bottom: 3rem; + text-align: center; +} + +article header h1 { + color: #4EA1FF; + font-size: 2.5rem; + margin-bottom: 1rem; +} + +article .meta { + color: #90B8E3; + font-size: 0.9rem; +} + +article .meta span { + margin: 0 0.5rem; +} + +article .content { + font-size: 1.1rem; + line-height: 1.8; +} + +article .content h2 { + color: #4EA1FF; + margin: 2.5rem 0 1.5rem; + font-size: 1.8rem; +} + +article .content h3 { + color: #4EA1FF; + margin: 2rem 0 1rem; + font-size: 1.4rem; +} + +article .content p { + margin-bottom: 1.5rem; + color: #e0e0e0; +} + +article .content ul, +article .content ol { + margin-bottom: 1.5rem; + padding-left: 1.5rem; +} + +article .content li { + margin-bottom: 0.5rem; +} + +article .content pre { + background: #0A1622; + border: 1px solid #1E3449; + border-radius: 8px; + padding: 1rem; + margin: 1.5rem 0; + overflow-x: auto; +} + +article .content code { + color: #4EA1FF; + font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace; +} + +article .content .cta { + background: #15202B; + border: 1px solid #1E3449; + border-radius: 8px; + padding: 2rem; + margin: 3rem 0; + text-align: center; +} + +article .content .cta p { + color: #4EA1FF; + font-size: 1.2rem; + margin-bottom: 1rem; +} + +article footer { + margin-top: 4rem; + padding-top: 2rem; + border-top: 1px solid #1E3449; +} + +article .tags { + margin-bottom: 2rem; +} + +/* Remove share section */ +.share { + display: none; } \ No newline at end of file