> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Install Bloc PWA on iOS, Android, or Desktop

> Bloc is a Progressive Web App. Install it on your phone, tablet, or desktop from your browser — no app store needed. Works on iOS, Android, and Chrome.

Because Bloc is a Progressive Web App (PWA), you can install it directly from your browser onto any device — no App Store, no Google Play, no waiting for an update to download. Once installed, Bloc gets its own icon on your home screen or taskbar, opens in a clean full-screen window without browser chrome, and works offline right away. It updates silently in the background whenever you're connected, so you're always on the latest version without doing a thing.

<Tabs>
  <Tab title="iOS / Safari">
    Safari on iPhone and iPad is the recommended browser for installing Bloc on Apple devices.

    <Steps>
      <Step title="Open Bloc in Safari">
        Launch Safari and navigate to [bloc.so](https://bloc.so). Sign in if you haven't already. Make sure you're using Safari — iOS currently only supports PWA installation from Safari.
      </Step>

      <Step title="Tap the Share button">
        Tap the **Share** button at the bottom of the screen (the box with an arrow pointing upward). On iPad, the Share button is in the top toolbar.
      </Step>

      <Step title="Tap Add to Home Screen">
        Scroll through the share sheet and tap **Add to Home Screen**. You can edit the app name if you wish.
      </Step>

      <Step title="Tap Add">
        Tap **Add** in the top-right corner to confirm. The Bloc icon will appear on your home screen immediately.
      </Step>
    </Steps>

    <Tip>
      After installation, open Bloc from your home screen icon rather than from Safari. This launches the app in standalone mode with more screen space and a smoother experience.
    </Tip>
  </Tab>

  <Tab title="Android / Chrome">
    Chrome on Android detects that Bloc is installable and offers a prompt automatically after a short visit.

    <Steps>
      <Step title="Open Bloc in Chrome">
        Open Chrome and go to [bloc.so](https://bloc.so). Sign in to your account.
      </Step>

      <Step title="Open the Chrome menu">
        Tap the **⋮** (three-dot) menu in the top-right corner of the browser.
      </Step>

      <Step title="Tap Add to Home Screen or Install App">
        Tap **Add to Home Screen** or **Install App** — the exact label depends on your version of Chrome. Confirm the app name and tap **Add** or **Install**.
      </Step>

      <Step title="Find Bloc on your home screen">
        The Bloc icon appears on your home screen and in your app drawer. Tap it to launch the app in standalone mode.
      </Step>
    </Steps>

    <Tip>
      Some Android devices also show an "Install app" banner at the bottom of the Chrome window automatically. Tap **Install** on that banner to skip the menu steps.
    </Tip>
  </Tab>

  <Tab title="Desktop (Chrome / Edge)">
    On desktop, Chrome and Microsoft Edge both support PWA installation from the address bar.

    <Steps>
      <Step title="Open Bloc in Chrome or Edge">
        Navigate to [bloc.so](https://bloc.so) in Google Chrome or Microsoft Edge and sign in.
      </Step>

      <Step title="Click the install icon in the address bar">
        Look for a small **install** icon (a monitor with a down arrow, or a plus sign in a circle) at the right end of the address bar. Click it.

        If you don't see the icon, open the browser menu (**⋮** in Chrome or **...** in Edge) and look for **Install Bloc** or **Install site as app**.
      </Step>

      <Step title="Confirm the installation">
        A small dialog appears asking you to confirm. Click **Install**. Bloc opens in its own app window.
      </Step>

      <Step title="Find Bloc in your applications">
        Bloc is now pinned to your taskbar (Windows) or available in your Applications folder (macOS). You can launch it like any desktop app.
      </Step>
    </Steps>

    <Tip>
      On Windows, you can right-click the Bloc taskbar icon and select **Pin to taskbar** so it's always one click away.
    </Tip>
  </Tab>
</Tabs>

<Note>
  After your first visit to Bloc in any browser, a service worker caches the app shell and your notes locally. This means Bloc loads and works fully offline — even if you open it before the icon has been installed.
</Note>

<Info>
  You don't need to install Bloc at all to use it. The full app works in any modern browser tab. Installation is optional and just makes launching Bloc more convenient.
</Info>