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

# Mobile: install Beebole on your phone or tablet

> Install Beebole as a progressive web app on your phone, tablet, or desktop and use the responsive layout, dark mode, and on-the-go time tracking.

Beebole works on any device with a web browser — phone, tablet, or desktop. You can also install it as an app on your device for a native-like experience, complete with an app icon and full-screen mode.

<Info>
  This page covers installing the Beebole web app on your device (PWA). The separate [Beebole desktop app](/help/documentation/desktop-app) is a companion that drafts time entries from your computer activity — you can use both.
</Info>

***

## Installing Beebole as an app

Beebole is a Progressive Web App (PWA), which means you can install it directly from your browser without going through an app store. Once installed, Beebole appears as a standalone app on your home screen or taskbar.

### On iPhone or iPad

<Steps>
  <Step title="Open Beebole in Safari">
    Navigate to your Beebole account URL in Safari.
  </Step>

  <Step title="Tap the Share button">
    Tap the **Share** icon at the bottom of the screen.
  </Step>

  <Step title="Add to Home Screen">
    Scroll down and tap **Add to Home Screen**. Give the app a name and tap **Add**.
  </Step>
</Steps>

### On Android

<Steps>
  <Step title="Open Beebole in Chrome">
    Navigate to your Beebole account URL in Chrome.
  </Step>

  <Step title="Tap the install prompt">
    Chrome displays an **Install** banner or you can tap the menu (three dots) and select **Install app** or **Add to Home screen**.
  </Step>

  <Step title="Confirm installation">
    Tap **Install**. Beebole appears as an app on your home screen.
  </Step>
</Steps>

### On desktop (Windows, macOS, Linux)

<Steps>
  <Step title="Open Beebole in your browser">
    Navigate to your Beebole account URL in Chrome, Edge, or another compatible browser.
  </Step>

  <Step title="Install the app">
    Click the install icon in the address bar, or go to the browser menu and select **Install Beebole**.
  </Step>

  <Step title="Launch from your desktop">
    Beebole now appears in your applications list and can be pinned to your taskbar or dock.
  </Step>
</Steps>

<Tip>
  The installed app runs in its own window without browser navigation bars, giving you more screen space for your timesheets and reports.
</Tip>

***

## Responsive layout

Beebole's interface adapts automatically to your screen size. Whether you are on a large monitor or a small phone screen, all features remain accessible:

* **Desktop** — Full layout with sidebar navigation, detailed tables, and expanded views.
* **Tablet** — Optimized layout that adjusts columns and spacing for medium-sized screens.
* **Phone** — Compact layout with simplified navigation and touch-friendly controls.

You do not need to switch between different apps or URLs. The same Beebole account works seamlessly across all devices.

***

## Theme settings

Beebole supports three theme options to match your visual preference:

| Theme     | Behavior                                                          |
| --------- | ----------------------------------------------------------------- |
| **Light** | Standard light background                                         |
| **Dark**  | Dark background that reduces eye strain in low-light environments |
| **Auto**  | Automatically matches your device's system theme setting          |

To change your theme, click the button with your initials at the bottom of the sidebar to open the user menu, then pick **Light**, **Dark**, or **Auto**.

<Info>
  The theme setting is personal and applies only to your account. It does not affect other people in your organization.
</Info>

***

## Logging time on mobile

The mobile timesheet is optimized for touch interaction. It presents your time entries as a scrollable list of days rather than a weekly grid, making it easier to navigate on a small screen.

### How to log hours

<Steps>
  <Step title="Open your timesheet">
    Tap the hamburger menu icon in the top-left corner to open the sidebar, then tap **Timesheet**.
  </Step>

  <Step title="Add a time entry">
    Tap the **+** button at the bottom of the screen (floating action button) or the **+** icon next to a specific day. The activity selector opens as a bottom sheet.
  </Step>

  <Step title="Select a project, task, or absence">
    Choose what you worked on from the list. Tap a project, task, or absence type to open the time entry editor.
  </Step>

  <Step title="Enter your time">
    In the editor bottom sheet, enter the duration or set start and end times (depending on your account configuration). Your entry saves automatically — tap the back arrow to return to the list.
  </Step>
</Steps>

### Editing and deleting entries

* **Tap** a time entry card to open the editor bottom sheet and update the duration, project, or comment.
* **Swipe left** on a time entry to reveal the delete action. Confirm deletion in the dialog that appears.

<Info>
  Editing and deleting are disabled when the timesheet period is locked (submitted or approved). The swipe-to-delete gesture and tap-to-edit are both blocked until the period is unlocked.
</Info>

### Using the timer on mobile

<Steps>
  <Step title="Start the timer">
    On a time entry card, tap the play button on the right side of the card. The timer starts and the entry shows a running red counter.
  </Step>

  <Step title="Monitor the timer">
    While the timer is running, a timer bar appears at the top of the header showing the active project and elapsed time.
  </Step>

  <Step title="Stop the timer">
    Tap the red stop button in the timer bar or on the entry card. Beebole saves the elapsed time as the entry's duration.
  </Step>
</Steps>

<Tip>
  The timer only appears on today's entries and is disabled when the timesheet is locked.
</Tip>

### Submitting timesheets on mobile

When your timesheet is ready for approval, tap the **Submit** button in the header. The button is visible when the period is in draft or rejected state and you are viewing your own timesheet.

After submission, the period is locked and the header shows the **Submitted** status badge. If your approver rejects the timesheet, the period unlocks and a **Resubmit** button appears in its place.

### Navigating periods with infinite scroll

The mobile timesheet uses infinite scroll rather than week-by-week navigation:

* **Scroll down** to load future periods automatically.
* **Pull down** from the top of the list to load previous periods. A pull-to-refresh indicator shows when you have pulled far enough to trigger the load.
* Month banners appear in the scroll list whenever the date crosses into a new month.
* A **Today** button appears in the footer when today is out of view. Tap it to scroll back to the current day.

### Approving team timesheets on mobile

Managers and administrators see a team button in the header (person group icon) with a badge showing the number of pending approvals.

<Steps>
  <Step title="Open the approval sheet">
    Tap the team icon in the header. The approval bottom sheet slides up with two tabs: **Pending** and **Team**.
  </Step>

  <Step title="Select a timesheet">
    Tap a person's entry in the **Pending** tab to view their submitted timesheet.
  </Step>

  <Step title="Approve or reject">
    With the submitter's timesheet open, tap **Approve** or **Reject** in the header. Rejection requires a comment.
  </Step>
</Steps>

You can also select multiple timesheets using checkboxes and bulk-approve or bulk-reject them from the action bar that appears at the bottom of the sheet.

***

## Related content

<CardGroup cols={2}>
  <Card title="Timesheets" icon="clock" href="/help/documentation/timesheets">
    Learn all the ways to log and manage time entries on desktop and mobile.
  </Card>

  <Card title="Approvals" icon="check" href="/help/documentation/approval">
    Submit and approve timesheets from any device, including directly from email.
  </Card>
</CardGroup>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Do I need to download Beebole from an app store?">
    No. Beebole is a Progressive Web App (PWA) that you install directly from your browser. There is no app store download required.
  </Accordion>

  <Accordion title="What can I do in Beebole on mobile?">
    The mobile layout is focused on day-to-day time tracking: logging and editing time entries, running the timer, submitting your timesheet for approval, and (for managers) approving or rejecting team timesheets. More detailed configuration and reporting are best handled on a larger screen.
  </Accordion>

  <Accordion title="Can I use Beebole offline?">
    Beebole requires an internet connection to sync your data. However, the installed PWA may cache some interface elements for faster loading when you reconnect.
  </Accordion>

  <Accordion title="How do I switch between dark and light mode?">
    Click the button with your initials at the bottom of the sidebar to open the user menu, then pick **Light**, **Dark**, or **Auto**. The **Auto** option automatically follows your device settings.
  </Accordion>

  <Accordion title="Can an administrator set the theme for the entire organization?">
    No. Theme selection is a personal preference. Each person chooses their own theme independently.
  </Accordion>
</AccordionGroup>