Skip to content

chore(mirror): sync docs from pieces-documentation (22773218187) #89

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
piecesdocumentationbot merged 1 commit into from
Mar 6, 2026
Merged

chore(mirror): sync docs from pieces-documentation (22773218187) #89

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions public/content/desktop/download.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,16 +31,16 @@ Read this [guide on determining your CPU architecture](/products/desktop/trouble
For detailed instructions, refer to our comprehensive [macOS installation and quick-start guide.](/products/meet-pieces/macos-installation-guide)

<CardGroup cols={2}>
<Card title="Apple Silicon / ARM" image="/assets/icons/platform_logos/macos_logo.png" href="https://builds.pieces.app/stages/production/macos_packaging/pkg-pfd-arm64/download?download=true&product=DOCUMENTATION_WEBSITE">
*macOS 12.0 (Monterey) or higher*
<Card title="Apple Silicon / ARM" image="/assets/icons/platform_logos/macos_logo.png" href="https://builds.pieces.app/stages/production/pieces_for_x/dmg-arm64/download?download=true&product=DOCUMENTATION_WEBSITE">
*macOS 13.0 (Ventura) or higher*
</Card>

<Card title="Intel" image="/assets/icons/platform_logos/macos_logo.png" href="https://builds.pieces.app/stages/production/macos_packaging/pkg-pfd/download?download=true&product=DOCUMENTATION_WEBSITE">
*macOS 12.0 (Monterey) or higher*
<Card title="Intel" image="/assets/icons/platform_logos/macos_logo.png" href="https://builds.pieces.app/stages/production/pieces_for_x/dmg/download?download=true&product=DOCUMENTATION_WEBSITE">
*macOS 13.0 (Ventura) or higher*
</Card>
</CardGroup>

Otherwise, you can download Pieces software using [alternative installation methods](/products/meet-pieces/macos-installation-guide) (.DMG, Homebrew).
Otherwise, you can download Pieces software using [alternative installation methods](/products/meet-pieces/macos-installation-guide) (.PKG, Homebrew).

### Windows

Expand Down
68 changes: 34 additions & 34 deletions public/content/meet-pieces/macos-installation-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,30 +23,38 @@ ogImage: "https://storage.googleapis.com/hashnode_product_documentation_assets/o
Click the **buttons below** to download Pieces for your macOS device.

<CardGroup cols={2}>
<Card title="Download — Pieces Desktop App (ARM)" image="/assets/icons/platform_logos/macos_logo.png" href="https://builds.pieces.app/stages/production/macos_packaging/pkg-pfd-arm64/download?download=true&product=DOCUMENTATION_WEBSITE" gaEvent="macos_pfd_download_pkg_arm" gaPlatform="macos">
<Card title="Download — Pieces Desktop App (ARM)" image="/assets/icons/platform_logos/macos_logo.png" href="https://builds.pieces.app/stages/production/pieces_for_x/dmg-arm64/download?download=true&product=DOCUMENTATION_WEBSITE" gaEvent="macos_pfd_download_dmg_arm" gaPlatform="macos">
*macOS 13.0 (Ventura) or higher required*
</Card>

<Card title="Download — Pieces Desktop App (Intel)" image="https://storage.googleapis.com/hashnode_product_documentation_assets/cdn_migrate_repair_2/intel.png" href="https://builds.pieces.app/stages/production/macos_packaging/pkg-pfd/download?download=true&product=DOCUMENTATION_WEBSITE" gaEvent="macos_pfd_download_pkg_intel" gaPlatform="macos">
<Card title="Download — Pieces Desktop App (Intel)" image="https://storage.googleapis.com/hashnode_product_documentation_assets/cdn_migrate_repair_2/intel.png" href="https://builds.pieces.app/stages/production/pieces_for_x/dmg/download?download=true&product=DOCUMENTATION_WEBSITE" gaEvent="macos_pfd_download_dmg_intel" gaPlatform="macos">
*macOS 13.0 (Ventura) or higher required*
</Card>
</CardGroup>

<Callout type="alert">
PiecesOS is a required Core Dependency. It will be installed while installing Pieces Desktop.
PiecesOS is a required Core Dependency. After you move Pieces Desktop to your Applications folder and open it for the first time, you'll be guided through installing PiecesOS automatically.
</Callout>

## Install the PKG
## Install the DMG

Once you’ve downloaded the correct `.pkg` file, it’s time to run the installer.
Once you've downloaded the correct `.dmg` file, it's time to install the Pieces Desktop App.

<Steps>
<Step title="Open the Installer">
Double-click the `.pkg` file to launch the macOS installer.
<Step title="Find the download">
Open your **Downloads** folder (or wherever you saved the installer) and look for the `.dmg` file you just downloaded (e.g., `Pieces.dmg`).
</Step>

<Step title="Mount the DMG">
Double-click the `.dmg` file to mount it.
</Step>

<Step title="Follow the On-Screen Prompts">
Navigate through the introduction screen, select the install location, and enter your administrator credentials if prompted, then click `Install Software`.
<Step title="Drag & Drop into Applications">
Drag the application icon from the mounted `.dmg` window into your **Applications** folder.
</Step>

<Step title="Eject the DMG">
Go back to **Finder**, right-click the mounted image, and select **Eject** to unmount it.
</Step>
</Steps>

Expand All @@ -56,9 +64,9 @@ There are <mark>(2)</mark> requirements for installing Pieces on your macOS devi

1. Compatible OS Version—**macOS 13.0 (Ventura) or higher**

2. Compatible installer for your device’s architecture—**Apple Silicon (ARM) or Intel**
2. Compatible installer for your device's architecture—**Apple Silicon (ARM) or Intel**

Click here for a quick guide on [determining your OS type](/products/meet-pieces/troubleshooting/macos#checking-os-version), and here for [how to check your device’s CPU architecture.](/products/meet-pieces/troubleshooting/macos#checking-cpu-type)
Click here for a quick guide on [determining your OS type](/products/meet-pieces/troubleshooting/macos#checking-os-version), and here for [how to check your device's CPU architecture.](/products/meet-pieces/troubleshooting/macos#checking-cpu-type)

***

Expand All @@ -73,51 +81,43 @@ Click here for a quick guide on [determining your OS type](/products/meet-pieces

## Alternative Installations

If you cannot use the `.pkg` installer for any reason, you can install PiecesOS and the Pieces Desktop App using standalone `.dmg` files or by using `Homebrew` through your Mac’s terminal.
If you cannot use the `.dmg` installer for any reason, you can install PiecesOS and the Pieces Desktop App using `.pkg` files or by using `Homebrew` through your Mac's terminal.

### via DMG (Apple Silicon / M-Series / ARM)

Install the Pieces Desktop App **in order** by clicking the download card below for your **ARM** device. PiecesOS will be installed as a core dependency with Pieces Desktop.
### via PKG (Apple Silicon / M-Series / ARM)

<CardGroup cols={1}>
<Card title="Download — Pieces Desktop App (DMG / ARM)" image="/assets/icons/platform_logos/macos_logo.png" href="https://builds.pieces.app/stages/production/pieces_for_x/dmg-arm64/download" gaEvent="macos_pfd_download_dmg_arm" gaPlatform="macos">
*Recommended Method*

<Card title="Download — Pieces Desktop App (PKG / ARM)" image="/assets/icons/platform_logos/macos_logo.png" href="https://builds.pieces.app/stages/production/macos_packaging/pkg-pfd-arm64/download?download=true&product=DOCUMENTATION_WEBSITE" gaEvent="macos_pfd_download_pkg_arm" gaPlatform="macos">
macOS 13.0 (Ventura) or higher required.
</Card>
</CardGroup>

### via DMG (Intel)

Install the Pieces Desktop App **in order** by clicking the download card below for your **Intel** device. PiecesOS will be installed as a core dependency with Pieces Desktop.
### via PKG (Intel)

<CardGroup cols={1}>
<Card title="Download — Pieces Desktop App (DMG / Intel)" image="https://storage.googleapis.com/hashnode_product_documentation_assets/cdn_migrate_repair_2/intel.png" href="https://builds.pieces.app/stages/production/pieces_for_x/dmg/download" gaEvent="macos_pfd_download_dmg_intel" gaPlatform="macos">
*Recommended Method*

<Card title="Download — Pieces Desktop App (PKG / Intel)" image="https://storage.googleapis.com/hashnode_product_documentation_assets/cdn_migrate_repair_2/intel.png" href="https://builds.pieces.app/stages/production/macos_packaging/pkg-pfd/download?download=true&product=DOCUMENTATION_WEBSITE" gaEvent="macos_pfd_download_pkg_intel" gaPlatform="macos">
macOS 13.0 (Ventura) or higher required.
</Card>
</CardGroup>

## Install the DMG
### Install the PKG

After downloading the correct `.dmg` file, it’s time to install the Pieces Desktop App.
Once you've downloaded the correct `.pkg` file, it's time to install the Pieces Desktop App.

<Steps>
<Step title="Find the download">
Open your **Downloads** folder (or wherever you saved the installer) and look for the `.dmg` file you just downloaded (e.g., `Pieces.dmg`).
Open your **Downloads** folder (or wherever you saved the installer) and look for the `.pkg` file you just downloaded.
</Step>

<Step title="Mount the DMG">
Double-click the `.dmg` file to mount it.
<Step title="Run the installer">
Double-click the `.pkg` file to launch the installer wizard.
</Step>

<Step title="Drag & Drop into Applications">
Drag the application icon from the mounted `.dmg` window into your **Applications** folder.
<Step title="Follow the prompts">
Click through the on-screen prompts—review the license agreement and enter your administrator password when prompted.
</Step>

<Step title="Eject the DMG">
Go back to **Finder**, right-click the mounted image, and select **Eject** to unmount it.
<Step title="Complete the installation">
Once the installer finishes, click `Close`. The Pieces Desktop App and PiecesOS are now installed in your **Applications** folder and ready to use.
</Step>
</Steps>

Expand Down Expand Up @@ -147,7 +147,7 @@ Alternatively, you may opt to install Pieces via Homebrew in your terminal.

## Post-Installation Tips

Read the documentation below for some tips and information to make sure you’re up and running with the latest version(s) of PiecesOS and the Pieces Desktop App, as well as steps to uninstall Pieces software from your Apple device.
Read the documentation below for some tips and information to make sure you're up and running with the latest version(s) of PiecesOS and the Pieces Desktop App, as well as steps to uninstall Pieces software from your Apple device.

### Updating

Expand Down