diff --git a/docs/mobile-app-guide/README.md b/docs/mobile-app-guide/README.md index 9eea7a9b91d9..a9e7fb56e673 100644 --- a/docs/mobile-app-guide/README.md +++ b/docs/mobile-app-guide/README.md @@ -7,97 +7,71 @@ keywords: Mobile app guide, mobile, mobile application, iOS, android, app store, --- # Mobile app guide (Beta) -We are excited to announce the **Beta Release** of the **OpenProject Mobile app** — now available in the **App Store** and **Google Play Store**. This Beta version marks the beginning of our journey to bring **OpenProject** to your mobile devices, enabling you to stay connected and productive wherever you are. +The **OpenProject Mobile app (Beta)** is available for **iOS** and **Android**. It is designed as a **companion app** to OpenProject’s web experience, giving you mobile access to essential project workflows so you can stay connected and productive when you’re away from your desk. > [!NOTE] -> The app is currently under active development, and core features are being continuously improved. We invite you to test the app, share feedback, and help shape the future of OpenProject Mobile. +> The app is currently under active development. Some features are still evolving, and new capabilities will be added over time. We welcome feedback to help shape OpenProject Mobile. -## Purpose and Vision +## Purpose and vision -The **OpenProject Mobile app** is designed as a **companion application** to the OpenProject web and desktop experience. It allows you to: +The OpenProject Mobile app focuses on mobile-first workflows that complement the full OpenProject web application. With the mobile app, you can: -- **Access your work packages** and projects on the go. -- **React and respond** quickly to updates, comments, and notifications. -- **Stay informed** about project progress, tasks, and deadlines — anytime, anywhere. -- **Track your work and log time** directly within the app to keep your reporting up to date. +- **Access your projects, meetings, and work packages** on the go. +- **React and respond quickly** to updates and discussions. +- **Stay informed** about project progress, tasks, meetings, and deadlines. +- **Track and log time** directly in the app to keep reporting up to date. +- Use additional mobile-friendly flows to support work in the field, for example, capturing and attaching photos. -The goal is to provide **lightweight mobile access** for essential collaboration and project management tasks, perfectly complementing the full web experience of OpenProject. +For complete functionality and administration, use the **OpenProject web application**. -## Current Beta Features +## What’s included in the current Beta -In this initial Beta version, you can: +OpenProject Mobile is organized into modules. See the module guides for details: -- Log in securely with your **OpenProject credentials.** -- View and edit your **work packages.** -- **Comment** and **reply** to discussions. -- View your **portfolio, program or project** details. -- Receive **notifications** about updates and mentions. -- Quickly **search** and **filter** work packages. -- **Track** and **log** your work time. +| Module | Description | +| --- | --- | +| [**Home Dashboard**](core-features/home-dashboard) | Your personal overview of tasks, notifications, and project updates, giving you a quick snapshot of what matters most. | +| [**Work Packages**](core-features/work-packages) | Create, view, and edit work packages directly from the app. Work packages are organized for quick access and easy collaboration. | +| [**Notifications**](core-features/notification-center) | Receive updates about comments, mentions, and work package changes, ensuring you never miss an important activity. | +| [**Time Tracking**](core-features/time-tracking) | Track time spent on work packages, run timers in focus mode, and keep your reporting accurate and up to date. | +| [**Meetings**](core-features/meetings) | Access and react to meeting agendas, series, and details directly in the app. | +| [**Global search**](core-features/global-search) | Search across all the content available in the app from a single place. | +| [Spaces](core-features/projects) | Browse your projects, access project-specific details, and stay on top of deadlines and activities. | +| [**User Settings**](core-features/user-settings) | Configure your account, manage app preferences, and tailor notifications to suit your workflow. | -## Mobile-Only Features +## Mobile-first capabilities -The **OpenProject Mobile App** introduces a set of features built specifically for mobile devices, designed to make project management faster, more focused, and more convenient wherever you are: +The OpenProject Mobile app includes features designed specifically for mobile devices: -- **Attach photos directly from your camera:** Capture and upload images instantly to work packages or comments — ideal for documenting on-site work, visual progress, or issues in real time. -- **Local notifications:** Stay up to date with mentions, comments, and task updates through local notifications — even when the app isn’t open. _These notifications are not yet real-time push notifications._ -- **Create work packages fast:** Quickly add new work packages in a distraction-free interface designed for fast, mobile-friendly input. -- **Run timers in focus mode:** Track your work time effortlessly with built-in timers that run in the background, helping you stay focused and accurate with time logs. -- **Configure modules and dashboards:** Customize what you see by enabling only the modules and views most relevant to you — keeping your mobile workspace clean and efficient. -- **Optimized touch interface:** Navigate with ease using gestures, adaptive layouts, and mobile-first design tailored for smaller screens. +- **Attach photos directly from your camera:** capture and upload images to work packages or comments—useful for documenting on-site work, progress, or issues in real time. +- **Run timers (focus mode):** track your work time with built-in timers that support accurate time logging. +- **Configure modules and dashboards:** customize what you see by enabling only the modules and views most relevant to you. +- **Tablet specific navigation and interface:** use an interface optimized for larger screens and tablet navigation patterns to make it easier to browse and work across the app on iPad/Android tablets. +- **Integrated mobile app feedback flow:** send product feedback directly from within the app (via user settings), making it easy to report issues or share suggestions while you work. +- **Switch between instances without logging out:** move between different OpenProject instances without having to fully log out and log back in each time. +- **Touch-optimized navigation:** a mobile-first interface built for smaller screens and quick interactions. +- **OS-level widgets:** you can place quick OS widgets on your phone’s home screen to work directly from outside the OpenProject app. -These mobile-specific capabilities enhance your ability to **work efficiently, document instantly, and stay connected** — all while maintaining focus and flexibility on the go. +These mobile-specific capabilities enhance your ability to **work efficiently, document instantly, and stay connected** — all while maintaining focus and flexibility on the go. -## Coming Soon +## What’s coming next -The app is still under development, and many core features are planned for future updates, including: +The mobile app is still evolving. The next focus areas include: -- **Deep-linking (including on-premises support):** Seamlessly open specific work packages, projects, or comments directly from links in emails, chats, or browser pages — whether you’re using the cloud or an on-premises instance. -- **Multi-device UI:** Enjoy a consistent, responsive experience across phones, tablets and macOS, with layouts optimized for each device size and orientation. -- **Real-time push notifications:** Receive updates instantly as they happen — from mentions and comments to task status changes — ensuring you never miss important activity. -- **Meeting agendas in the app:** Access and review meeting agendas on the go to stay prepared and aligned with your team wherever you are. - -These upcoming features will make the OpenProject Mobile App even more connected, collaborative, and aligned with the full OpenProject experience. +- **Bringing more OpenProject core modules to mobile**, such as **Documents** and **Wikis** +- **Offline capability**, to support working with limited or unreliable connectivity +- The mobile app supports a **multi-device experience on tablets** today. Additional device support is planned, including expansion toward **desktop**. +- Receive updates instantly with **real-time push notifications** as they happen, from mentions and comments to task status changes, ensuring you never miss important activity. ## Feedback and Involvement -As a Beta user, your feedback is invaluable. If you encounter issues or have suggestions, please let us know:  - -- Using the **flow to provide feedback** directly from the **app** in the user settings. -![Entry point for the OpenProject mobile app flow to provide user feedback](mobile_app_feedback_flow_entrypoint.png) -- Create a **feedback work package** directly in [OpenProject **Community** instance](https://community.openproject.org/) and assign it to _Stream Mobile App_. - -Your input directly helps improve the mobile experience and ensure a stable, feature-rich public release. - -## Availability - -The **OpenProject Mobile App (Beta)** is available now for: - -- **iOS:** [App Store link](https://apps.apple.com/us/app/openproject/id6474431879). -- **Android:** [Google Play link](https://play.google.com/store/apps/details?id=org.openproject.app). +Your feedback helps improve OpenProject Mobile. If you encounter issues or have suggestions, you can: -## Requirements +- Use the **flow to provide feedback** directly from the **app** in user settings. +- Create a **feedback work package** directly in the [**OpenProject Community instance**](https://community.openproject.org/) and assign it to *Stream Mobile App*. -To access and use the **OpenProject Mobile App (Beta)**, you’ll need the following: - -- **An active OpenProject account:** Either from an **OpenProject Cloud** workspace or an **OpenProject On-premises** installation with API access enabled. -- Having a **signed certificate** (**https**, not http) on your instance to be able to log in. -- **OpenProject version:** 17.0.0 or above - -> [!NOTE] -> If you have a previous version of OpenProject you can connect your OpenProject instance by asking your administrator to enable the Built in OAuth applications flag under_ `_{BASE_URL}/admin/settings/experimental_`. - -- **Minimum system requirements:** - - **iOS 17** or later - - **Android 12** or later -- **Built-in OAuth applications enabled:** Make sure that the built-in OAuth applications are **enabled in your administration settings** (`{BASE_URL}/admin/oauth/applications`). This is required for successful login from the mobile app. -![Applications setting to enable the built-in OAuth](mobile_app_oauth_authentication.png) -- **Network connection:** Internet access is required for syncing data with your OpenProject instance. - -> [!NOTE] -> Some features, such as deep-linking and real-time push notifications, may depend on your organization’s configuration or will become available in future updates. ## Disclaimer > [!IMPORTANT] -> This is a **Beta Release**, which means the app may contain incomplete features and occasional bugs. We recommend using it alongside the **OpenProject web application** for the full experience. +> This is a **Beta release**. The app may include incomplete features and occasional bugs. We recommend using it alongside the **OpenProject web application** for the full experience. \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/README.md b/docs/mobile-app-guide/core-features/README.md index 13eafde50b69..a29f96a3cecc 100644 --- a/docs/mobile-app-guide/core-features/README.md +++ b/docs/mobile-app-guide/core-features/README.md @@ -1,42 +1,27 @@ --- sidebar_navigation: - title: Mobile app core features - priority: 800 + title: Mobile app modules + priority: 880 description: The OpenProject Mobile App is designed to keep you connected to your projects wherever you are. While it doesn’t replace the full desktop experience, it provides access to the essential tools you need to stay productive on the go. keywords: Mobile app core features, mobile, mobile app, core, mobile core, core features --- -# Mobile app core features +# Mobile app modules -The **OpenProject Mobile App** is designed to keep you connected to your projects wherever you are. While it doesn’t replace the full desktop experience, it provides access to the essential tools you need to stay productive on the go. - -This section introduces the **core features** of the app and links to detailed guides for each functionality. - -## Overview - -With the mobile app, you can: - -- **Stay informed** about project updates and notifications -- **Manage work packages** efficiently from anywhere -- **Track your time** and log progress -- **Access project dashboards and overviews** at a glance -- **Customize your settings** to tailor the app to your workflow - -Each feature is designed to complement the OpenProject web and desktop experience, giving you the flexibility to react, update, and communicate on the go. - -## Core Features - -The following core features are available in the mobile app: - -| Feature | Description | -|---------------------------------------------------------------------|:-----------------------------------------------------------------------------------| -| [Home Dashboard](home-dashboard) | Your personal overview of tasks, notifications, and project updates — giving you a quick snapshot of what matters most. | -| [Projects](projects) | Browse your projects, access project-specific details, and stay on top of deadlines and activities. | -| [Time Tracking](time-tracking) | Track time spent on work packages, run timers in focus mode, and keep your reporting accurate and up to date. | -| [Work Packages](work-packages)| Create, view, and edit work packages directly from the app. Work packages are organized for quick access and easy collaboration. | -| [Notification Center](notification-center) | Receive updates about comments, mentions, and work package changes — ensuring you never miss an important activity. | -| [User Settings](user-settings) | Configure your account, manage app preferences, and tailor notifications to suit your workflow. | -| [Tablet support](tablet-support) | Use OpenProject mobile app on tablets. | +OpenProject’s mobile app is organized into **modules**. Each module focuses on a specific area of day-to-day work, from browsing and updating work packages to reviewing meetings and quickly finding information with global search. > [!TIP] > For a seamless experience, use the mobile app alongside the web or desktop version of OpenProject. The app is designed as a companion, so you can stay informed, respond quickly, and keep your projects moving — even when you’re away from your desk. + +## Available modules + +| Module | Description | +| --- | --- | +| [**Home Dashboard**](home-dashboard) | Your personal overview of tasks, notifications, and project updates — giving you a quick snapshot of what matters most. | +| [**Work Packages**](work-packages) | Create, view, and edit work packages directly from the app. Work packages are organized for quick access and easy collaboration. | +| [**Notifications**](notification-center) | Receive updates about comments, mentions, and work package changes — ensuring you never miss an important activity. | +| [**Time Tracking**](time-tracking) | Track time spent on work packages, run timers in focus mode, and keep your reporting accurate and up to date. | +| [**Meetings**](meetings) | Access and react to meeting agendas, series and details directly in the app. | +| [**Global search**](global-search) | Search across all the content available in the app from a single place. | +| [Spaces](projects) | Browse your projects, access project-specific details, and stay on top of deadlines and activities. | +| [**User Settings**](user-settings) | Configure your account, manage app preferences, and tailor notifications to suit your workflow. | \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/global-search/README.md b/docs/mobile-app-guide/core-features/global-search/README.md new file mode 100644 index 000000000000..1e4870e2f21f --- /dev/null +++ b/docs/mobile-app-guide/core-features/global-search/README.md @@ -0,0 +1,29 @@ +--- +sidebar_navigation: + title: Global search + priority: 750 +description: A centralized view to search all entities in the mobile app. +keywords: Mobile app global search, search, mobile search, global search, OpenProject mobile app +--- + +# Global search + +**Global search** lets you search across multiple types of content in your OpenProject instance from one place. Use it to quickly find what you need without manually browsing through projects, spaces or lists. + +At the moment, global search supports: + +- **Work packages** +- **Spaces / Projects** + +Work is ongoing to also make **meetings** available through global search. + +![View of the supported search criteria in the app](global_search-search_supported.png) + +### What you can do + +With global search you can: + +- Search by keyword or ID across supported content types. +- Filter down the list using quick filters related to each content type. +- See results grouped by type (for example, work packages vs. projects). +- Open a result directly to continue your work. \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/global-search/global_search-search_supported.png b/docs/mobile-app-guide/core-features/global-search/global_search-search_supported.png new file mode 100644 index 000000000000..5191d5a33b1a Binary files /dev/null and b/docs/mobile-app-guide/core-features/global-search/global_search-search_supported.png differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/README.md b/docs/mobile-app-guide/core-features/home-dashboard/README.md index 7d8d0e422f7c..1f5ec9d9531b 100644 --- a/docs/mobile-app-guide/core-features/home-dashboard/README.md +++ b/docs/mobile-app-guide/core-features/home-dashboard/README.md @@ -6,83 +6,51 @@ description: Create a personalized overview of your projects, work packages, and keywords: Mobile app features home dashboard --- -# Home Dashboard +# Home dashboard -The **Home Dashboard** is your go-to screen for staying informed, focused, and efficient on mobile — providing an at-a-glance view of everything that matters across your projects. It allows creating a **personalized overview of your projects, work packages, and activities**, helping you stay informed and productive on the go. +The **Home dashboard** is the starting point of the OpenProject mobile app. It gives you quick access to your most important items and helps you continue where you left off without navigating through multiple projects first. -The dashboard is designed to give you **quick access to the information you care about most**, without needing to navigate deep into individual projects or work packages. +Use the Home dashboard to get an overview of what needs attention, jump back into recent work, and access key areas of the app faster. -## Purpose +## What you can do on the Home dashboard -The Home Dashboard is your **central hub** for project management on mobile. Its main purposes include: +Depending on your configuration and permissions, the Home dashboard can help you: -- **Quickly reviewing your priorities:** See which work packages, deadlines, or updates need your attention. -- **Monitoring project activity:** Stay up to date on work package changes, comments, and progress across all your projects. -- **Accessing relevant widgets:** Customize what you see based on your workflow and focus areas. -- **Saving time:** Avoid switching between multiple screens — everything important is consolidated in one view. +- **Resume recent work:** Quickly jump back to items you recently opened (for example, work packages or projects). +- **See what needs attention:** Review assigned items, updates, or other high-signal content surfaced on the dashboard. +- **Navigate to key areas:** Use dashboard shortcuts to open commonly used parts of the app without browsing through the full project list. -## Available Widgets +## What appears on the Home dashboard -The Home Dashboard consists of **modular widgets** that provide snapshots of your most relevant data. Depending on your role and project access, some widgets may vary. +The Home dashboard is built from **sections/widgets** that summarize or link to content. The full list of widgets available in the app are: -### Notifications +- Notifications +- Assigned to me +- Recently viewed +- Upcoming meetings +- Time tracker +- Week time tracking +- Favorite spaces +- Portfolios -- Displays recent notifications, such as mentions, comments, or work package updates. -- Enables you to **react quickly** without leaving the dashboard. +![All available Home dashboard widgets](home_dashboard-widgets.png) -![Home dashboard notifications widget in the OpenProject mobile app](mobile_app_homewidget_notifications.png) - -### Favorite Projects - -- Displays projects you’ve marked as favorites for **quick access**. -- Ideal for prioritizing high-importance projects. - -![Home dashboard displaying "favorite projects" widget in the OpenProject mobile app](mobile_app_homewidget_favoriteprojects.png) - -### Time Tracker - -- Shows the **currently running timer** or allows you to start a new focus timer. -- Helps track work time efficiently and accurately. - -![Home dashboard displaying the "time tracker" widget in OpenProject mobile app](mobile_app_homewidget_timetracker.png) - -### Week Time Tracking - -- Provides an overview of **time logged during the current week**. -- Helps you monitor your productivity and ensure accurate reporting. - -![Home dashboard displaying "week time tracking" widget in the OpenProject mobile app](mobile_app_homewidget_weektimetracking.png) - -### Portfolios - -- Shows a snapshot of the portfolios available. -- Useful for portfolio managers and team members tracking **high-level progress** across multiple projects. - -![Home dashboard displaying "portfolios" widget in the OpenProject mobile app](mobile_app_homewidget_portfolios.png) - -### Assigned to Me - -- Lists all **work packages currently assigned to you**. -- Includes work package types and status indicators for quick task management. - -![Home dashboard displaying "work packages assigned to me" widget in the OpenProject mobile app](mobile_app_homewidget_assignedtome.png) +> [!NOTE] +> The exact set of sections can vary depending on your OpenProject instance configuration, permissions, memberships, and what you have configured to be visible in the app settings. -### Recently Edited +## Customize your Home dashboard -- Shows a list of **recently edited work packages**. -- Allows **fast navigation** back to items that are work in progress. +While the mobile dashboard is designed for simplicity, you can customize the **order and visibility of widgets** using the **Edit widgets button** on the right side of the top navigation bar. Tapping the icon lets you show or hide widgets and reorder them. -![Home dashboard displaying "work packages recently edited" widget in the OpenProject mobile app](mobile_app_homewidget_recentlyedited.png) +![Add and reorder widgets to the Home dashboard](home_dashboard-add_widgets.png) -## Customizing the Dashboard +## Home screen widgets on your phone -While the mobile dashboard is designed for simplicity, the **order and visibility of widgets** can be customized by using the **edit widgets button** on the right side of the top navigation bar. Clicking the icon allows you to: +Most of the widgets you see on the **Home dashboard** are also available as **OS-level widgets** that you can place on your phone’s home screen, outside of the OpenProject app. -- Activate and deactivate widgets -- Reorder widgets +This lets you: -![Home dashboard edit widgets entry point in OpenProject mobile app](mobile_app_home_addwidget.png) -![Home dashboard edit widgets bottom sheet configuration in OpenProject mobile app](mobile_app_home_addwidget_bottomsheet.png) +- See key OpenProject information at a glance without opening the app. +- Jump directly into relevant areas or items faster from your device's home screen. -> [!NOTE] -> If you don't have the right permissions or have disabled a feature, the related widgets will be deactivated in the home dashboard tab. +The exact set of available OS widgets (and what they show) can vary depending on your platform (iOS or Android) and the app version. diff --git a/docs/mobile-app-guide/core-features/home-dashboard/home_dashboard-add_widgets.png b/docs/mobile-app-guide/core-features/home-dashboard/home_dashboard-add_widgets.png new file mode 100644 index 000000000000..b86210e08342 Binary files /dev/null and b/docs/mobile-app-guide/core-features/home-dashboard/home_dashboard-add_widgets.png differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/home_dashboard-widgets.png b/docs/mobile-app-guide/core-features/home-dashboard/home_dashboard-widgets.png new file mode 100644 index 000000000000..4ac0d8901391 Binary files /dev/null and b/docs/mobile-app-guide/core-features/home-dashboard/home_dashboard-widgets.png differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_home_addwidget.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_home_addwidget.png deleted file mode 100644 index 8fb551f3636c..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_home_addwidget.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_home_addwidget_bottomsheet.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_home_addwidget_bottomsheet.png deleted file mode 100644 index 981f5178b23f..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_home_addwidget_bottomsheet.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_assignedtome.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_assignedtome.png deleted file mode 100644 index 65112acf25ba..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_assignedtome.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_favoriteprojects.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_favoriteprojects.png deleted file mode 100644 index 508679e5da5c..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_favoriteprojects.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_notifications.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_notifications.png deleted file mode 100644 index 34413627dedf..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_notifications.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_portfolios.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_portfolios.png deleted file mode 100644 index a03f04ca672e..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_portfolios.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_recentlyedited.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_recentlyedited.png deleted file mode 100644 index b96a5c912b78..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_recentlyedited.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_timetracker.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_timetracker.png deleted file mode 100644 index 9255eb136cac..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_timetracker.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_weektimetracking.png b/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_weektimetracking.png deleted file mode 100644 index c1f1bbc3795e..000000000000 Binary files a/docs/mobile-app-guide/core-features/home-dashboard/mobile_app_homewidget_weektimetracking.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/meetings/README.md b/docs/mobile-app-guide/core-features/meetings/README.md new file mode 100644 index 000000000000..76f29b98c633 --- /dev/null +++ b/docs/mobile-app-guide/core-features/meetings/README.md @@ -0,0 +1,114 @@ +--- +sidebar_navigation: + title: Meetings + priority: 740 +description: Plan, run, and review meetings in OpenProject from the mobile app. +keywords: Mobile app meetings, meetings module, meetings, meetings app, OpenProject mobile app +--- + +# Meetings + +The **Meetings** module lets you plan, run, and review meetings in OpenProject from the mobile app. It supports both **individual meetings** and **recurring meeting series**, and provides everything you need to manage agendas, outcomes, participants, and related work. + +## What you can do + +With the Meetings module, you can: + +- View **all meetings**, including: + - **individual meetings**, and + - **meeting series** (recurring meetings). +- Browse meetings within a series, including **upcoming** and **past** meetings. +- **Search and filter** meetings (for example, by project or by switching queries). +- Open meeting details and work with: + - **Agenda** + - **Backlog** + - **Details** + - **Participants** + - **Attachments** +- Update the **meeting status** (for example, when the meeting starts or ends). +- Manage agendas: + - add, edit, move, and delete **agenda sections**, + - add, edit, move, and delete **agenda items**, + - link **work packages** to agenda items. +- Add and edit **outcomes** while a meeting is in progress. +- **Create** meetings: + - create a new **individual meeting**, or + - create a new **meeting series**. +- **Delete or cancel** meetings with the correct permissions. +- View **linked meetings inside work packages** as a dedicated tab in the work package view. + +## Common workflows + +### Find a meeting + +1. Open **Meetings**. +2. Use the **project filter** (e.g., *All projects*) to narrow down the scope. +3. Use the **query selector** (e.g., *My meetings*) to switch what you are viewing. +4. Use **search** to find a meeting by title. + +![How to find a meeting in the app](meetings-find_a_meeting.png) + +### Review upcoming or past meetings in a series + +1. Open **Meetings**. +2. Open a **meeting series**. +3. Switch between **upcoming** and **past** meetings to locate the instance you need. +4. Tap a meeting to open its details. + +![Meeting series index page](meetings-series_index.png) + +### Prepare the agenda + +1. Open a meeting and go to **Agenda**. +2. Add **agenda sections** to structure the meeting. +3. Add **agenda items** under the right section. +4. If the discussion relates to work items: + - link existing **work packages** to agenda items, or + - create a new work package (if supported and permitted). + +![Meeting agenda details view](meetings-agenda.png) + +### Run the meeting + +1. Open the meeting. +2. Update the **meeting status** to indicate it is in progress (if used in your workflow). +3. While discussing agenda items, add or update **outcomes** to document decisions and next steps. + +![Status update and writing outcomes in a meeting](meetings-status_and_outcomes.png) + +### Change meeting details or participants, or attach files + +1. Open the meeting and use the available tabs: + 1. **Details:** View and change the meeting's general details, its status and change the email calendar updates for all participants. + 2. **Participants:** View and add participants to the meeting. + 3. **Attachments:** Attach relevant files or photos to the meeting. +2. Add or modify the desired data. + +![Meeting details, participants and attachments views](meeting-details.png) + +### Create a new meeting or meeting series + +You can create new meetings directly from the **Meetings** module. + +1. Open **Meetings**. +2. Tap the **+** button (top right). +3. Choose what you want to create: + - **One-time meeting** (individual meeting), or + - **Recurring meeting** (meeting series). +4. Fill in the required details, such as: + - meeting title, + - project, + - date and time (or start date and recurrence pattern for a series), + - participants. +5. Tap **Create**. + +After creation, the meeting opens in its detail view, where you can start preparing the **agenda**, add **attachments**, and, once the meeting starts, capture **outcomes**. + +![Meeting creation flow](meetings-creation.png) + +## Linked meetings in work packages + +Additionally, the meetings related to a work package can also be accessed from the **work package detail view** via a dedicated **Meetings** tab. Use this when you start from a work item and want to: + +- check meeting context around that work package, +- review outcomes or discussion history tied to the item. \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/meetings/meeting-details.png b/docs/mobile-app-guide/core-features/meetings/meeting-details.png new file mode 100644 index 000000000000..42ee92a27203 Binary files /dev/null and b/docs/mobile-app-guide/core-features/meetings/meeting-details.png differ diff --git a/docs/mobile-app-guide/core-features/meetings/meetings-agenda.png b/docs/mobile-app-guide/core-features/meetings/meetings-agenda.png new file mode 100644 index 000000000000..0db50217afa1 Binary files /dev/null and b/docs/mobile-app-guide/core-features/meetings/meetings-agenda.png differ diff --git a/docs/mobile-app-guide/core-features/meetings/meetings-creation.png b/docs/mobile-app-guide/core-features/meetings/meetings-creation.png new file mode 100644 index 000000000000..321ab67ac116 Binary files /dev/null and b/docs/mobile-app-guide/core-features/meetings/meetings-creation.png differ diff --git a/docs/mobile-app-guide/core-features/meetings/meetings-find_a_meeting.png b/docs/mobile-app-guide/core-features/meetings/meetings-find_a_meeting.png new file mode 100644 index 000000000000..738f2c1d18d3 Binary files /dev/null and b/docs/mobile-app-guide/core-features/meetings/meetings-find_a_meeting.png differ diff --git a/docs/mobile-app-guide/core-features/meetings/meetings-series_index.png b/docs/mobile-app-guide/core-features/meetings/meetings-series_index.png new file mode 100644 index 000000000000..4dd033b0a818 Binary files /dev/null and b/docs/mobile-app-guide/core-features/meetings/meetings-series_index.png differ diff --git a/docs/mobile-app-guide/core-features/meetings/meetings-status_and_outcomes.png b/docs/mobile-app-guide/core-features/meetings/meetings-status_and_outcomes.png new file mode 100644 index 000000000000..e67ecaa3556d Binary files /dev/null and b/docs/mobile-app-guide/core-features/meetings/meetings-status_and_outcomes.png differ diff --git a/docs/mobile-app-guide/core-features/notification-center/README.md b/docs/mobile-app-guide/core-features/notification-center/README.md index 766d08b2f8e5..48e98737df4b 100644 --- a/docs/mobile-app-guide/core-features/notification-center/README.md +++ b/docs/mobile-app-guide/core-features/notification-center/README.md @@ -1,38 +1,88 @@ --- sidebar_navigation: title: Notification Center - priority: 750 -description: A centralized view of all updates, mentions, and activities that require the user’s attention in OpenProject mobile app. + priority: 760 +description: A centralized view of all updates, mentions, and activities that require the user’s attention in the OpenProject mobile app. keywords: Mobile app Notification Center, mobile notification, mobile notifications, notification, mobile mention --- -# Notification Center +# Notifications -The **Notification Center** provides a centralized view of all updates, mentions, and activities that require the user’s attention. It ensures users can stay informed about important changes across their projects, even while on the move. Notifications from the web or desktop application are synchronized with the mobile app, making it easy to keep track of all relevant activity in one place. +The **Notifications** module (notification center) helps you stay up to date with changes that matter to you, for example when you are **mentioned**, **assigned**, added as a **watcher**, or when a **date alert** is triggered. -## Receiving and Viewing Notifications +From here you can review unread items, open the relevant work package, and manage what you have already seen. -After logging into the app, you will automatically receive notifications generated in their OpenProject environment. Whenever an update occurs—such as a comment, status change, or mention—the notification will appear inside the Notification Center. You can simply open the app and navigate to the Notification Center to view any new, unread items waiting for their attention. +## Browse notifications -You can also choose to display **all notifications**, not just unread ones. By toggling the switch to view all items, the Notification Center expands to include both read and unread notifications. This is useful for revisiting past activity or reviewing a complete history of updates. +Each notification in the list shows key information at a glance including, the work package type and ID, the subject/title, project name, and why you received it, such as *Assignee* or *Mention*. Tap a notification to open it. -![OpenProject mobile app Notification Center](mobile_app_notification_centre.png) +![Available queries in the Notification center](notifications-queries.png) -## Viewing Notification Details +### Switch notification queries -Tapping on a notification opens the associated work package directly in the mobile app. You are taken to the Activity tab of that work package, where the specific update that triggered the notification is highlighted. This makes it easy to understand the context of the notification and respond immediately if needed. +Use the selector in the **top header** to switch between different notification queries, such as: -![OpenProject mobile app work package activity tab](mobile_app_workpackage_activity.png) +- **Inbox** +- **Mentioned** +- **Assignee** +- **Accountable** +- **Watcher** +- **Date alert** +- **Reminder** +- **Shared** -## Marking Notifications as Read +### Unread vs. all -When a notification is opened or manually marked as read, it is removed from the **Unread** inbox. This allows you to maintain a clear and focused view of only pending items. For quicker inbox management, the Notification Center also provides an option to **mark all notifications as read** from the top bar, clearing the unread list in a single action. +Below the header, use the toggle to switch between: -![Mark a notification as read by swiping it in the OpenProject mobile app](mobile_app_notification_centre_swipe_markasread.png) -![Mark a notification as read using the more menu in the OpenProject mobile app](mobile_app_notification_centre_moreaction_markasread.png) +- **Unread:** the default for catching up +- **All:** to review everything, including notifications marked as read -## Switching Between Notification Queries +## Common workflows -The Notification Center includes filters that allow you to switch between different notification queries, similar to the web interface. You can choose alternative inboxes—such as “Assignee,” “Mention,” or other notification categories their instance provides. When switching queries, the list updates immediately to show only the notifications relevant to that filter. +### Open a notification in context -![OpenProject mobile app switch the Notification Center query](mobile_app_notification_centre_queries.png) +When you open a notification, it takes you to the related **work package**, focused on the **Activity** tab so you can immediately see the update or conversation that triggered the notification. + +From there you can: + +- read the latest changes and comments, +- reply or add a comment, +- continue working on the work package, +- and mark the notification as read when the work is completed. + +![Notifications in the work package activity tab](notifications-activity.png) + +### Mark notifications as read + +To keep your inbox tidy, mark notifications as read after reviewing them. You can mark notifications as read by: + +- Using the more menu (three dots) in the notification list to mark all notifications from a single work package as read. +- Swipe the entire card to the right or left to mark all notifications from a single work package as read. +- Mark all notifications as read in the notification centre using the mark all as read action on the top right corner of the notification list. This action is also available on the header of the work package details view when it has notifications. +- Additionally, you can mark single activities as read without marking the rest inside the work packages activities by using the more menu (three dots) for each activity. + +![Different ways of marking notifications as read](notifications-mark_as_read.png) + +### Additional notification settings + +#### Manage notification settings (what you receive) + +If you want to change *which events* generate notifications, and which don’t, you can do so at any time from the app: + +1. Open **Account and settings**. +2. Go to **Notification settings**. +3. Enable or disable the notification types you want to receive. + +> [!NOTE] +> This is the central place to control your personal notification preferences. Changing these settings will affect the notifications received both on the mobile app and the core desktop app of OpenProject. + +#### Control when activities are marked as read automatically + +You can also configure *when* items are marked as read automatically while working in a work package’s **Activity** tab. In **Account and settings → Work package settings**, choose one of the following behaviors: + +- **Automatically mark all as read:** Automatically marks all notifications/activities as read as soon as you open the Activity tab. +- **Mark as read when commenting:** Marks all items as read only after you add a comment in the Activity tab. +- **Mark as read on reply:** Marks a specific activity as read when you **quote reply** to that specific activity entry. + +These options help you decide whether simply viewing activity should clear notifications, or whether they should only be cleared when you actively respond. \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre.png b/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre.png deleted file mode 100644 index f85fe9e04ea0..000000000000 Binary files a/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_moreaction_markasread.png b/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_moreaction_markasread.png deleted file mode 100644 index ef461bbaf03d..000000000000 Binary files a/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_moreaction_markasread.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_queries.png b/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_queries.png deleted file mode 100644 index 5a715b4b0782..000000000000 Binary files a/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_queries.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_swipe_markasread.png b/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_swipe_markasread.png deleted file mode 100644 index 319a64438e26..000000000000 Binary files a/docs/mobile-app-guide/core-features/notification-center/mobile_app_notification_centre_swipe_markasread.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/notification-center/mobile_app_workpackage_activity.png b/docs/mobile-app-guide/core-features/notification-center/mobile_app_workpackage_activity.png deleted file mode 100644 index a4807936459b..000000000000 Binary files a/docs/mobile-app-guide/core-features/notification-center/mobile_app_workpackage_activity.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/notification-center/notifications-activity.png b/docs/mobile-app-guide/core-features/notification-center/notifications-activity.png new file mode 100644 index 000000000000..7179a1c91ecd Binary files /dev/null and b/docs/mobile-app-guide/core-features/notification-center/notifications-activity.png differ diff --git a/docs/mobile-app-guide/core-features/notification-center/notifications-mark_as_read.png b/docs/mobile-app-guide/core-features/notification-center/notifications-mark_as_read.png new file mode 100644 index 000000000000..4fa3d708c509 Binary files /dev/null and b/docs/mobile-app-guide/core-features/notification-center/notifications-mark_as_read.png differ diff --git a/docs/mobile-app-guide/core-features/notification-center/notifications-queries.png b/docs/mobile-app-guide/core-features/notification-center/notifications-queries.png new file mode 100644 index 000000000000..c2d1613cb714 Binary files /dev/null and b/docs/mobile-app-guide/core-features/notification-center/notifications-queries.png differ diff --git a/docs/mobile-app-guide/core-features/projects/README.md b/docs/mobile-app-guide/core-features/projects/README.md index 7ccaf5211119..a00d7d64348a 100644 --- a/docs/mobile-app-guide/core-features/projects/README.md +++ b/docs/mobile-app-guide/core-features/projects/README.md @@ -1,52 +1,52 @@ --- sidebar_navigation: - title: Projects - priority: 780 + title: Spaces + priority: 730 description: An organized view of all portfolios, programs, and projects you have access to. keywords: Mobile app features projects, mobile project, mobile portfolio, mobile program, program, programme, project, portfolio, mobile app --- -# Projects +# Spaces -The **Projects module** in the OpenProject Mobile App gives you an organized view of all **portfolios, programs, and projects** you have access to. It allows you to **check status, attributes, and progress**, explore hierarchy, and navigate seamlessly between different levels of work. +The **Spaces** module helps you browse and open the portfolios, programs, and projects you have access to in OpenProject. It provides a structured overview (including hierarchies, when configured) and lets you quickly jump into a specific space to continue working, for example by opening the space overview or its work packages. -## Purpose +## What you can do -The Projects module is designed to help you: +With the Spaces module, you can: -- **Monitor progress and status** of projects, programs, and portfolios. -- **View all attributes and key details** of a portfolio, program, or project. -- **Understand hierarchy** by exploring the relationship between portfolios, programs, and projects. -- **Access work packages and child projects** of portfolios, programs, and projects directly from the mobile interface. +- **Browse spaces** you have access to. +- **Filter** the list by type. +- **Search** for a specific space by name. +- Mark spaces as **favorites** and quickly access them via the Favorites view. +- **Open a space** to view its details and navigate to its work packages or sub-spaces. -This module is particularly useful for team members, project managers, and portfolio managers who need a **clear overview of ongoing work and its organization**. +## Common workflows -## Project Index +### Browse all spaces and filter by type -The main screen of the Projects module acts as an **index page**, allowing you to: +1. Open **Spaces**. +2. Use the **type selector** in the header (e.g., *All types*) to narrow the list. +3. Use **search** to find a specific space/project by name. +4. Scroll the list and tap an entry to open it. -- **Enter Portfolios, Programs, or individual Projects** directly. -- **Browse a hierarchical list of all projects**, expandable to show programs and child projects. -- **Filter the list** to display only your **favorite projects** for quick access. +![Spaces filter by type](spaces-type_filter.png) -![Project module index in the OpenProject mobile app](mobile_app_projectsmodule.png) +### Switch between All and Favorites -## Portfolio, Program, and Project Details +1. Open **Spaces**. +2. Use the toggle below the header to switch between: + - **All** (everything you can access), and + - **Favorites** (spaces you’ve starred). -When you enter a portfolio, program, or project, the mobile app provides three key tabs for detailed insights: +This is useful if you mainly work in a small set of spaces and want faster access. -1. **Overview Tab** - - Shows the **description, status, and all available attributes** of the selected item. - - Provides a snapshot of key details at a glance. -2. **Work Packages Tab** - - Lists **all work packages** associated with the portfolio, program, or project. - - Allows you to view, open, and interact with tasks directly from the app. -3. **In this Portfolio / Program / Project** - - Displays all **projects or programs that belong to the selected portfolio, program, or project**. - - Helps you explore the hierarchy and drill down into individual initiatives. +![Spaces navigation between all and favorites](spaces-favorites.png) -![Project details overview in the OpenProject mobile app](mobile_app_project_overview.png) +### Open a space and review details or navigate to work -![Project details work packages in the OpenProject mobile app](mobile_app_project_workpackages.png) +When you open a space/project, you can typically: -![Project details sub-elements in the project in the OpenProject mobile app](mobile_app_project_inthisportfolio.png) +- Review the **Overview,** which summarizes project attributes and the description. +- Navigate to **Work packages** within that space/project to see and work on items. + +![Overviews of the spaces to check its important details](spaces-overviews.png) \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/projects/mobile_app_project_inthisportfolio.png b/docs/mobile-app-guide/core-features/projects/mobile_app_project_inthisportfolio.png deleted file mode 100644 index 87e776199b3e..000000000000 Binary files a/docs/mobile-app-guide/core-features/projects/mobile_app_project_inthisportfolio.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/projects/mobile_app_project_overview.png b/docs/mobile-app-guide/core-features/projects/mobile_app_project_overview.png deleted file mode 100644 index c0590b1fc1ae..000000000000 Binary files a/docs/mobile-app-guide/core-features/projects/mobile_app_project_overview.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/projects/mobile_app_project_workpackages.png b/docs/mobile-app-guide/core-features/projects/mobile_app_project_workpackages.png deleted file mode 100644 index 0752be806db5..000000000000 Binary files a/docs/mobile-app-guide/core-features/projects/mobile_app_project_workpackages.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/projects/mobile_app_projectsmodule.png b/docs/mobile-app-guide/core-features/projects/mobile_app_projectsmodule.png deleted file mode 100644 index 40540aa677cd..000000000000 Binary files a/docs/mobile-app-guide/core-features/projects/mobile_app_projectsmodule.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/projects/spaces-favorites.png b/docs/mobile-app-guide/core-features/projects/spaces-favorites.png new file mode 100644 index 000000000000..bdfe4664a9aa Binary files /dev/null and b/docs/mobile-app-guide/core-features/projects/spaces-favorites.png differ diff --git a/docs/mobile-app-guide/core-features/projects/spaces-overviews.png b/docs/mobile-app-guide/core-features/projects/spaces-overviews.png new file mode 100644 index 000000000000..9bab71bfa43b Binary files /dev/null and b/docs/mobile-app-guide/core-features/projects/spaces-overviews.png differ diff --git a/docs/mobile-app-guide/core-features/projects/spaces-type_filter.png b/docs/mobile-app-guide/core-features/projects/spaces-type_filter.png new file mode 100644 index 000000000000..9b8245a074e8 Binary files /dev/null and b/docs/mobile-app-guide/core-features/projects/spaces-type_filter.png differ diff --git a/docs/mobile-app-guide/core-features/tablet-support/README.md b/docs/mobile-app-guide/core-features/tablet-support/README.md deleted file mode 100644 index 4a9b12a6d0bb..000000000000 --- a/docs/mobile-app-guide/core-features/tablet-support/README.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -sidebar_navigation: - title: Tablet support - priority: 750 -description: Tablet support and split-screen navigation. -keywords: Mobile app tablet support, tablet ui, tablet, split screen tablet, tablet navigation ---- - -# Tablet support and split-screen navigation - -The OpenProject Mobile App is optimized not only for smartphones but also for larger devices such as **tablets**. The adaptive interface automatically adjusts to the available screen size, providing a more spacious and productive layout on tablets. - -![Work package full view on a tablet device](work-packages_split-screen.png) - -## Split-screen navigation - -On tablets, the mobile app uses a **split-screen layout** that allows you to keep lists and detailed views visible at the same time. - -This makes it easier to navigate through projects and work packages without constantly switching between screens. - -With the split-screen layout you can: - -- View a **list of projects or work packages** on one side of the screen. -- Open the **details of a selected project or work package** on the other side. -- Navigate through items while keeping the list visible. -- Quickly switch between work packages when reviewing or updating tasks. - -This layout helps maintain context while browsing and makes it easier to work with multiple items in sequence. - -![Work package list with a work package open on a split view on a tablet device](work-packages_list.png) - -The tablet interface therefore provides a navigation experience that is closer to the desktop version while remaining fully optimized for touch interaction. diff --git a/docs/mobile-app-guide/core-features/tablet-support/work-packages_list.png b/docs/mobile-app-guide/core-features/tablet-support/work-packages_list.png deleted file mode 100644 index 89e03d490430..000000000000 Binary files a/docs/mobile-app-guide/core-features/tablet-support/work-packages_list.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/tablet-support/work-packages_split-screen.png b/docs/mobile-app-guide/core-features/tablet-support/work-packages_split-screen.png deleted file mode 100644 index 20f216961af8..000000000000 Binary files a/docs/mobile-app-guide/core-features/tablet-support/work-packages_split-screen.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/README.md b/docs/mobile-app-guide/core-features/time-tracking/README.md index ec67eedbfb0d..468e3463f974 100644 --- a/docs/mobile-app-guide/core-features/time-tracking/README.md +++ b/docs/mobile-app-guide/core-features/time-tracking/README.md @@ -8,47 +8,58 @@ keywords: Mobile app features time tracking, time tracking, mobile time tracking # Time tracking -The **Time Tracking** module in the OpenProject Mobile App enables you to easily record, review, and manage the time you spend on your work. Whether you prefer logging time manually or using a real-time focus timer, the module offers a clear and efficient mobile workflow. +The **Time tracking** module lets you track and log spent time in OpenProject from the mobile app. It is designed for quick time entry on the go, whether you want to log time for **yourself** or, with the proper permissions, log time for **other users**, including **multiple users at once**. -## Purpose +## Views -The Time Tracking feature helps you: +The Time tracking module is organized into three tabs: -- Keep accurate records of your work across projects -- Maintain consistent time reporting while on the move -- Review your weekly work patterns at a glance -- Track focused work sessions without distractions +- **Day:** See your logged time grouped by day and review the entries for the selected date. +- **Work week:** Get a weekly overview of your logged hours, including totals and a day-by-day breakdown. +- **Time tracker:** Track time actively with a running timer and link it to a work package when needed. -## Time Entries Index +![Time tracking views](time_tracking-views.png) -The **Time Entries Index** provides a clear, chronological view of all your logged time. What you can do: +## Common workflows -- **Browse weekly overviews:** Move between the current week and previous weeks to see all your recorded time entries. -- **Review logged hours:** See each entry with its associated work package, duration, and date. -- **Quick view chart:** Easily see the total of hours recorded by day in the weekly chart. +### Review your logged time -This view is ideal for maintaining accurate records and verifying past entries. +Use the **Day** or **Work week** tab to: -![Time tracking week logged time index page in the OpenProject mobile app](mobile_app_timetrackingmodule.png) -![Time tracking index page with a day of the week selected in the OpenProject mobile app](mobile_app_timetrackingmodule_dayfocused.png) +- see **your personal** time entries, +- review logged hours and daily/weekly totals, +- open entries for additional details and editing. -## Timer Focus Mode +> [!TIP] +> The app shows **only your personal time entries**, even if you logged time for other users. Time entries for other users are not displayed in the app (regardless of who created them). -The **Timer Focus Mode** allows you to track time as it happens, helping you stay focused and avoid manual entry errors. What you can do: +![Edit a logged time entry](time_tracking-edit_log.png) -- **Start a focus timer** on any work package to measure your work session in real time. -- **Let the timer run in the background**, even if you switch apps or lock your device. -- **Stop the timer** when finished, and convert the session into a logged time entry. +### Log time -![Timer running in a focus mode in the OpenProject mobile app](mobile_app_focustimer.png) -![Timer running in the background shown in the index page in the OpenProject mobile app](mobile_app_timerrunning.png) +You can create a new time entry from the Time tracking module. -## Log Time +1. Tap **+** (top right). +2. Tap **Log time**. +3. By default, you will be selected as **User** to log time**.** With the correct permissions you can select **another user** or **multiple users.** +4. Select a **Work package**. +5. Set the **Date**. +6. Enter **Hours**, including **exact times** if the instance allows it. +7. Fill in all the **mandatory fields** depending on the instance configuration. +8. Fill in other **optional fields** if desired. +9. Tap **Save** to create the time entry. -The **Log Time** feature allows you to manually enter time spent on work packages. What you can do: +![Log time flow](time_tracking-log_time.png) -- **Create a new time entry** for any work package. -- **Specify the date, duration, and activity type**. -- **Ensure accurate reporting** even if you didn’t use the focus timer. +## Track time with a running timer -![Log time modal in the OpenProject mobile app](mobile_app_logtime.png) +Use the **Time tracker** tab when you want to measure time as you work: + +- Start the timer using the **Start** button or the **+** button on the top bar. +- Optionally **link a work package** while the timer is running. +- You can always **Pause** the tracker if needed. +- **Stop** the timer when you are done. +- Review and edit the log time information. +- Tap **Save** to create the time entry or tap **Continue tracking** to keep the tracker running from where you left it. + +![Time tracker timer](time_tracking-timer.png) \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_focustimer.png b/docs/mobile-app-guide/core-features/time-tracking/mobile_app_focustimer.png deleted file mode 100644 index 728f0555c171..000000000000 Binary files a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_focustimer.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_logtime.png b/docs/mobile-app-guide/core-features/time-tracking/mobile_app_logtime.png deleted file mode 100644 index bfa90f9e4964..000000000000 Binary files a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_logtime.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timerrunning.png b/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timerrunning.png deleted file mode 100644 index 2c496d0c875f..000000000000 Binary files a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timerrunning.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timetrackingmodule.png b/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timetrackingmodule.png deleted file mode 100644 index 0ee640dfba5d..000000000000 Binary files a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timetrackingmodule.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timetrackingmodule_dayfocused.png b/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timetrackingmodule_dayfocused.png deleted file mode 100644 index 61e35358fef6..000000000000 Binary files a/docs/mobile-app-guide/core-features/time-tracking/mobile_app_timetrackingmodule_dayfocused.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/time_tracking-edit_log.png b/docs/mobile-app-guide/core-features/time-tracking/time_tracking-edit_log.png new file mode 100644 index 000000000000..15eb82873d47 Binary files /dev/null and b/docs/mobile-app-guide/core-features/time-tracking/time_tracking-edit_log.png differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/time_tracking-log_time.png b/docs/mobile-app-guide/core-features/time-tracking/time_tracking-log_time.png new file mode 100644 index 000000000000..121ec79ce85f Binary files /dev/null and b/docs/mobile-app-guide/core-features/time-tracking/time_tracking-log_time.png differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/time_tracking-timer.png b/docs/mobile-app-guide/core-features/time-tracking/time_tracking-timer.png new file mode 100644 index 000000000000..4b2f6ba934e0 Binary files /dev/null and b/docs/mobile-app-guide/core-features/time-tracking/time_tracking-timer.png differ diff --git a/docs/mobile-app-guide/core-features/time-tracking/time_tracking-views.png b/docs/mobile-app-guide/core-features/time-tracking/time_tracking-views.png new file mode 100644 index 000000000000..33753eb13147 Binary files /dev/null and b/docs/mobile-app-guide/core-features/time-tracking/time_tracking-views.png differ diff --git a/docs/mobile-app-guide/core-features/user-settings/README.md b/docs/mobile-app-guide/core-features/user-settings/README.md index 7286100cef95..f7a849bd16ec 100644 --- a/docs/mobile-app-guide/core-features/user-settings/README.md +++ b/docs/mobile-app-guide/core-features/user-settings/README.md @@ -1,35 +1,97 @@ --- sidebar_navigation: - title: User settings - priority: 740 -description: Personalize their mobile app experience, configure notifications, manage account details, and provide feedback. + title: Account and settings + priority: 720 +description: Personalize your mobile app experience, configure notifications, manage account details, and provide feedback. keywords: Mobile app features user settings, user settings, user rights, user permissions, mobile permission, mobile settings, mobile user, mobile notification settings --- -# User settings +# Account and settings -The **User Settings** module allows users to personalize their mobile app experience, configure notifications, manage account details, and provide feedback. All settings are accessible through the user avatar, giving a central location for managing preferences and account-specific options. +The **Account and settings** module allows you to manage your account, personalize and set up the OpenProject mobile app. It also provides access to help, release information, and support channels. -## Personalization +## What you can do -You can customize how the app behaves and appears to suit their workflow and preferences. The following options are available: +### Basic account information -- **Change Launch Page**: You can select which page the app opens to by default when launched. Once the new launch page is set, closing and reopening the app will open directly on the selected page. -- **Enabled Features:** Allows you to enable or disable specific features for a streamlined experience. This enables you to focus only on the tools relevant to their workflow. -- **Change Language**: You can select their preferred language, which updates all app labels, menus, and interface elements accordingly. -- **Switch Color Mode**: The app supports different color modes. You can switch between light, dark, or system-default modes to match your personal preference or device settings. +Review, and where supported, update your account information, such as: -## Account and Personal Details +- **Avatar** (not editable) +- **Username** (not editable) +- **First name** +- **Last name** +- **Email address** -You can manage their personal information from the **Account Details** section. Changes to the name, email, or other personal data are reflected across both the mobile app and desktop/web interface, ensuring consistency across all OpenProject platforms. +> [!NOTE] +> Some fields may be read-only in the mobile app, depending on how your OpenProject instance manages user accounts. -## Notifications +### Personalization -The Notification Settings section allows you to configure how and when they receive notifications: +Adjust how the app behaves and how it looks: -- **Deactivate Local Notifications**: You can disable OS-level local pull notifications, preventing alerts from appearing on their device. -- **Adjust Notification Preferences**: You can fine-tune which notifications they receive, such as participation alerts, non-participation alerts, or date-related reminders. Changes are applied to both mobile and desktop apps, and notifications will adhere to the new settings. +- **Launch page**: choose what the app opens by default. +- **Enabled modules**: control which modules appear in the app navigation. +- **Language**: set the app language. +- **Theme**: switch between **light mode,** **dark mode**, or switch depending on the **OS theme**. -## Feedback +### Notification settings -The app includes a **Feedback** section where you can provide suggestions, report issues, or share their experiences. Submitted feedback is sent to the OpenProject Mobile app team for review. +Control **what you receive notifications for**. + +This typically includes: + +- **Participation notifications** (e.g., when you are mentioned, assigned, watching, etc.) +- Non-participation notifications (e.g., new work packages, all date changes, all status updates, etc.) +- **Date alerts** (e.g., reminders or date-related notifications, depending on configuration) + +Use these settings to reduce noise and focus on what matters to you. + +> [!NOTE] +> These settings are global. If you change them in the app this will also affect what notifications you receive in the core OpenProject browser app. + +### Work package settings + +Configure how work packages behave in the app. + +This includes: + +- **Activity tab “mark as read” behavior:** Choose how notifications/activities are marked as read when using the **Activity** tab (for example, automatically when opening it, only when commenting, or only when replying with a quote). +- **Creation settings:** Adjust defaults used when creating new work packages. +- **Default page for work package lists:** Choose which of the default queries opens when you enter work package lists. + +### Crash reports (opt-in) + +You can choose whether to share **crash reports** with OpenProject. + +- Enabling crash reports helps improve the app by providing technical information when the app crashes. +- Disabling it prevents the app from sending crash diagnostics. + +### Give feedback + +Use **Give feedback** to contact the team and improve the app. + +The feedback flow typically lets you: + +- report a **bug** +- share general **feedback** +- request a **feature** + +In all of these cases, you can also add attachments and provide a **follow-up email address** so the team can contact you if more information is needed. + +### What’s new + +Open **What’s new** to review highlights from the latest mobile app releases. This is useful to discover newly added features and UI changes. + +### Mobile app documentation + +The mobile app documentation opens documentation guides in your browser, so you can look up how modules work and what features are available. + +### Switch instance + +If you use multiple OpenProject instances, **Switch instance** lets you switch between instance URLs **without signing out** each time. + +This is helpful when you work across multiple organizations or environments (for example, staging and production). + +### Sign out + +Ends your current session and signs you out of the OpenProject mobile app. \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/work-packages/README.md b/docs/mobile-app-guide/core-features/work-packages/README.md index 1b3d2cd5f573..700d3ee804fa 100644 --- a/docs/mobile-app-guide/core-features/work-packages/README.md +++ b/docs/mobile-app-guide/core-features/work-packages/README.md @@ -1,73 +1,80 @@ --- sidebar_navigation: title: Work packages - priority: 760 + priority: 780 description: Browse, search, create, update, and collaborate on work packages directly from your mobile device. keywords: Mobile app features work packages, work package, work packages, create work package, edit work package, share work package, mobile app --- # Work packages -The **Work Packages** module is one of the central components of the OpenProject Mobile App. It allows you to browse, search, create, update, and collaborate on work packages directly from your mobile device. The module includes full support for commenting, file attachments, relations, watchers, time logging, timers, and reminders. +**Work packages** are the central items you work with in OpenProject, for example tasks, features, bugs, milestones, or any other work item type configured in your instance. In the mobile app, the Work packages module lets you browse, search, update, and work packages while you are on the go. -## Purpose +## What you can do -The Work Packages module enables you to: +From the Work packages module, you can typically: -- Access and manage tasks across all your projects -- Create new work packages quickly or with full detail -- Update existing work packages -- Collaborate through comments and mentions -- Attach files, images, and photos directly from your device -- Manage relations, watchers, and attributes -- Track time and set reminders for upcoming work +- **Browse work packages** across projects and queries. +- **Search** for a specific work package by name. +- **Open work package details**, including overview and activity. +- **Edit** supported attributes and details. +- **Collaborate** by following updates, reviewing activity, and managing relations and watchers. +- Use **More actions** to share and access time-related actions. -## Work Packages Index +![Work package list view](work_packages-lists.png) -When accessing the Work Packages module, you are presented with a list of open work packages from all projects. This serves as the starting point for navigation and work package management, making it easy to view ongoing work at a glance. The module also offers flexible filtering tools that allow users to refine the list by selecting a specific project, applying a saved query, and adjusting sorting and grouping options. As filters are modified, the list dynamically adapts to show the corresponding work packages. -In addition to filtering, you can quickly locate specific work packages through the search functionality. Tapping the search icon opens a search bar where users can type keywords and instantly view matching results. +## Common workflows -![Work packages index page in the OpenProject mobile app](mobile_app_workpackages_index.png) +### Work packages lists -## Create Work Packages +Use the Work packages list to quickly find and open the item you want to work on. -Creating new work packages is also fully supported. You can tap the "+" button to begin the creation process. After selecting the work package type and project, you can fill in the required fields to quickly create a new entry. For more detailed entries, you may choose to open the full attribute list and complete optional fields before saving, resulting in a comprehensive work package with all available metadata. +- Use the **project selector** (e.g., *All projects*) to change the scope of what you are browsing. +- Use the **query selector** (e.g., *All open*) to change the query you are seeing. +- Use **search, sorting**, and **grouping** to find the relevant work package. +- Select a work package in the list to open its **details**. +- Long tap a work package to **preview** it. -![Work package creation bottom sheet to select a type in the OpenProject mobile app](mobile_app_create_workpackage_type.png) -![Work package creation details modal in the OpenProject mobile app](mobile_app_create_workpackage_details.png) +### Create a new work package -## Overview and Edit +You can create a new work package directly from the **Work packages** list. -You can open any work package to view its details and make updates. Editing is initiated through the pencil icon, giving access to fields such as the title, description, status, and any available custom fields. All updates are applied directly in the work package, so users can easily refine information as work progresses. +- Open **Work packages** from the main navigation. +- Tap the **+ button** (top right), which is also available from the Home dashboard. +- Select the work package **type**. +- Select the **project** where you want to create the work package. +- Fill in all the work package **mandatory details**. Any additional fields available for this work package type are available when tapping on **See all attributes** in the bottom bar. +- Tap **Create** to create the work package. -![Work package details on the overview tab in the OpenProject mobile app](mobile_app_workpackage_details_overview.png) +After creation, the work package opens in its detail view, where you can continue editing, add comments, attachments, relations, watchers, and more. -## Collaboration and Communication +![Create work package flow](work_packages-create.png) -The module supports collaboration through the **Activity** tab, where you can participate in discussions. Comments can be added or replied to, mentions can be used to involve other users, and images may be included directly in the comment body. This makes it easier to share updates, coordinate with your team, or provide visual information on the go. +### Work package overview and details -![Work package details on the activity tab in the OpenProject mobile app](mobile_app_workpackage_activity.png) +A work package detail view is organized into sections/tabs, such as: -Attachments are handled through the **Files** tab. You can upload files, photos, or videos from their device, or take a new picture using the camera and attach it immediately. This allows work packages to hold all relevant documentation in one place. +- **Overview:** The main summary view, typically including the work package description and key filled information. The fields are also editable from the overview tab. +- **Activity:** The activity feed for the work package (updates, comments, and changes). +- **Files:** Attachments and files related to the work package, with the option to add attachments. +- **Relations:** Related work packages (e.g., related to, predecessor/successor, children). You can navigate to related items and add relations. +- Meetings: Meetings linked to this work package as meeting agenda or outcome. You can open the respective meeting agendas. +- **Watchers:** People who are watching the work package. You can review watchers and add watchers. -![Work package details on the files tab in the OpenProject mobile app](mobile_app_workpackage_files.png) +![Work package details view and information tabs](work_packages-details.png) -Relations between work packages can be managed in the **Relations** tab, where you can connect tasks to one another by adding new relations when needed. Similarly, watchers can be added from the **Watchers** tab to keep stakeholders informed about progress or changes. +You can always **edit a work package** details from each field available on the overview screen, but for more advanced editing, tap on the Edit action (pencil icon) on the top navigation bar. -![Work package details on the activity tab in the OpenProject mobile app](mobile_app_workpackage_relations.png) -![Work package details on the activity tab in the OpenProject mobile app](mobile_app_workpackage_watchers.png) +### More actions -## Time Tracking and Reminders +From all tabs you can access the **More actions** menu (three dots) with additional options. Depending on your current view, these may include: -Time can be logged directly from a work package by opening the **More** menu and selecting the logging option. You can enter duration, date, activity, and any other necessary details to record their work accurately. For continuous time tracking, the app also supports starting a live timer from the same **More** menu. This opens the timer in focus mode, allowing you to track their work in real time while minimizing distractions. +- **Share link:** To share the work package through the OS sharing functionality. +- **Log time:** Log time to this work package. +- **Start timer:** Start a timer in the application to log time to this work package. +- **Start or stop watching:** Start or stop receiving notifications for this work package. +- **Set reminder:** Set a reminder for the future to receive a notification at the desired time. +- **Add to device calendar:** Add the work package to your native device calendar (available only if the work package has dates filled in). -Additionally, you can set reminders from within the **More** menu. By configuring a reminder for a specific date and time, the app will notify you when it’s time to return to that work package or take action on it. - -![Work package details with the more actions menu open in the OpenProject mobile app](mobile_app_workpackage_moreactions.png) - -## Sharing Work Packages - -Work packages can be easily shared using the device’s **native sharing features**. From within a work package, you can access the system share from the **More** menu to send a direct link to the item through messaging apps, email, collaboration tools, or any other app supported by their operating system. This simplifies cross-platform communication and makes it effortless to bring others into the loop. - -![Work package details sharing bottom sheet open in the OpenProject mobile app](mobile_app_workpackage_share.png) +![Work packages more actions](work_packages-more_actions.png) \ No newline at end of file diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_create_workpackage_details.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_create_workpackage_details.png deleted file mode 100644 index 7eb56456b856..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_create_workpackage_details.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_create_workpackage_type.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_create_workpackage_type.png deleted file mode 100644 index a59913d71bcd..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_create_workpackage_type.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_activity.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_activity.png deleted file mode 100644 index a4807936459b..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_activity.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_details_overview.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_details_overview.png deleted file mode 100644 index 6fe14bdddd07..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_details_overview.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_files.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_files.png deleted file mode 100644 index 942791269d13..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_files.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_moreactions.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_moreactions.png deleted file mode 100644 index 71ecea0ac4bd..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_moreactions.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_relations.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_relations.png deleted file mode 100644 index 65a7ac72a62c..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_relations.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_share.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_share.png deleted file mode 100644 index 6678f2ef94ba..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_share.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_watchers.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_watchers.png deleted file mode 100644 index a5230e3d8c31..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackage_watchers.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackages_index.png b/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackages_index.png deleted file mode 100644 index b4dcf433300e..000000000000 Binary files a/docs/mobile-app-guide/core-features/work-packages/mobile_app_workpackages_index.png and /dev/null differ diff --git a/docs/mobile-app-guide/core-features/work-packages/work_packages-create.png b/docs/mobile-app-guide/core-features/work-packages/work_packages-create.png new file mode 100644 index 000000000000..a6132d770180 Binary files /dev/null and b/docs/mobile-app-guide/core-features/work-packages/work_packages-create.png differ diff --git a/docs/mobile-app-guide/core-features/work-packages/work_packages-details.png b/docs/mobile-app-guide/core-features/work-packages/work_packages-details.png new file mode 100644 index 000000000000..2e47a369f458 Binary files /dev/null and b/docs/mobile-app-guide/core-features/work-packages/work_packages-details.png differ diff --git a/docs/mobile-app-guide/core-features/work-packages/work_packages-lists.png b/docs/mobile-app-guide/core-features/work-packages/work_packages-lists.png new file mode 100644 index 000000000000..7dd3c5bb5911 Binary files /dev/null and b/docs/mobile-app-guide/core-features/work-packages/work_packages-lists.png differ diff --git a/docs/mobile-app-guide/core-features/work-packages/work_packages-more_actions.png b/docs/mobile-app-guide/core-features/work-packages/work_packages-more_actions.png new file mode 100644 index 000000000000..31f8b9f7946e Binary files /dev/null and b/docs/mobile-app-guide/core-features/work-packages/work_packages-more_actions.png differ diff --git a/docs/mobile-app-guide/devices-platform/README.md b/docs/mobile-app-guide/devices-platform/README.md new file mode 100644 index 000000000000..1fae3a02bef0 --- /dev/null +++ b/docs/mobile-app-guide/devices-platform/README.md @@ -0,0 +1,34 @@ +--- +sidebar_navigation: + title: Devices and platform + priority: 870 +description: Tablet and desktop support for the OpenProject mobile app. +keywords: mobile app devices, device support, tablet, desktop, OpenProject mobile app +--- + +# Devices and platforms + +The OpenProject mobile app is designed first and foremost for **mobile use**. It supports both **iOS** and **Android** and is optimized for quick, on-the-go workflows such as checking notifications, updating work packages, or reviewing meeting agendas. + +At the same time, many teams also work on **larger screens**. The app can be used on tablets and desktop-sized devices to support scenarios where more screen space helps with navigation, reading, and multitasking. + +## Supported platforms + +- **iOS** +- **Android** + +## Using the app on larger screens + +If you use OpenProject on a tablet or a desktop-sized device, you may notice differences compared to a phone: + +- Layout and spacing adapt to larger displays, +- Navigation may appear differently depending on screen size and orientation, +- Some interactions may feel closer to a “desktop” experience. + +For details and platform-specific notes, see: + +| Page | Description | +| --- | --- | +|[**Tablet support**](tablet-support) | Guidance and known differences when using the app on tablets. + | +|[**Desktop support**](desktop-support) | Guidance for teams using the app on desktop-sized devices. | diff --git a/docs/mobile-app-guide/devices-platform/desktop-support/README.md b/docs/mobile-app-guide/devices-platform/desktop-support/README.md new file mode 100644 index 000000000000..2ad2b199f83a --- /dev/null +++ b/docs/mobile-app-guide/devices-platform/desktop-support/README.md @@ -0,0 +1,24 @@ +--- +sidebar_navigation: + title: Desktop support + priority: 780 +description: Desktop support for the OpenProject mobile app. +keywords: Mobile app desktop, desktop support, multi-device app, MacOS app, desktop app, OpenProject mobile app +--- + +# Desktop support + +The OpenProject mobile app is primarily designed for **mobile devices** (iOS and Android). We are actively working on improving support for **desktop-sized usage**, but there is currently **no dedicated desktop application** available for OpenProject Mobile. + +## Current desktop option (macOS) + +At the moment, the only way to use the OpenProject mobile app on a desktop device is on **macOS**, via an **App Store download** that runs a **scaled-up iPad version** of the app. + +Important notes: + +- This is **not** a desktop-optimized experience. +- The app is designed for **touch-first mobile/tablet usage**, so desktop input (mouse/keyboard), layout expectations, and workflows may feel limited or inconsistent. +- For these reasons, this option should be **used with caution**, especially for daily production use on desktop devices. + +> [!NOTE] +> We will be working on dedicated applications for desktop support soon. If you have special requests or feedback about possible desktop usage of the app, please send us your feedback. \ No newline at end of file diff --git a/docs/mobile-app-guide/devices-platform/tablet-support/README.md b/docs/mobile-app-guide/devices-platform/tablet-support/README.md new file mode 100644 index 000000000000..4915234d140c --- /dev/null +++ b/docs/mobile-app-guide/devices-platform/tablet-support/README.md @@ -0,0 +1,33 @@ +--- +sidebar_navigation: + title: Tablet support + priority: 790 +description: Tablet support for the OpenProject mobile app. +keywords: Mobile app tablet, tablet support, multi-device app, split-screen, tablet navigation, OpenProject mobile app +--- + +# Tablet support + +The OpenProject mobile app is designed for smartphones, but it is also optimized for **tablet devices**. On larger screens, the app uses an adaptive interface that takes advantage of the extra space to make navigation and review workflows more efficient. + +![OpenProject Home dashboard mobile app on a tablet device](tablet_support-home.png) + +## Split-screen navigation + +On tablets, the app uses a **split-screen layout**. This allows you to keep a list and a detail view visible at the same time, which reduces back-and-forth navigation. + +With split-screen navigation, you can: + +- Keep a **list of spaces/projects or work packages** visible on one side of the screen. +- Open the **details** of a selected space/project or work package on the other side. +- Move through items in the list while keeping the context visible. +- Quickly switch between work packages when reviewing or updating items in sequence. + +This tablet layout provides a navigation experience that is closer to the desktop version, while remaining fully optimized for touch interaction. + +![Tablet specific navigation with split-screen mode](tablet_support-split_view.png) + +## Notes + +- The exact layout can vary depending on your device, screen size, and orientation. +- Some UI details may differ slightly between iOS and Android, but the split-screen concept remains the same. \ No newline at end of file diff --git a/docs/mobile-app-guide/devices-platform/tablet-support/tablet_support-home.png b/docs/mobile-app-guide/devices-platform/tablet-support/tablet_support-home.png new file mode 100644 index 000000000000..5077609dbd0f Binary files /dev/null and b/docs/mobile-app-guide/devices-platform/tablet-support/tablet_support-home.png differ diff --git a/docs/mobile-app-guide/devices-platform/tablet-support/tablet_support-split_view.png b/docs/mobile-app-guide/devices-platform/tablet-support/tablet_support-split_view.png new file mode 100644 index 000000000000..ef45e972ea85 Binary files /dev/null and b/docs/mobile-app-guide/devices-platform/tablet-support/tablet_support-split_view.png differ diff --git a/docs/mobile-app-guide/faq/README.md b/docs/mobile-app-guide/faq/README.md deleted file mode 100644 index 389b22b2a910..000000000000 --- a/docs/mobile-app-guide/faq/README.md +++ /dev/null @@ -1,143 +0,0 @@ ---- -sidebar_navigation: - title: Mobile app FAQ - priority: 800 -description: FAQ of the OpenProject Mobile app. -keywords: Mobile app FAQ, faq, mobile app questions, OpenProject mobile app ---- - -# Mobile app FAQ - -## Why is the OpenProject Mobile App being released in a Beta state? - -The app is released in **Beta** state to provide early access to users while the core functionality is still under development. This allows the OpenProject team to gather **feedback from real users**, identify issues, and make improvements before the full public release. The Beta release ensures that users can start using the app for essential tasks while the remaining advanced features and refinements are being implemented. - -## What is the OpenProject Mobile App? - -The OpenProject Mobile App is a companion to the OpenProject desktop and web applications. It allows users to **stay informed, manage work packages, track time, and collaborate** while on the go. The app is currently in **Beta**, meaning core features are available, but some advanced functionalities are still under development. - -## What platforms are supported? - -- **iOS 17 or later** -- **Android 12 or later** - -The app requires an **active internet connection** to sync data with your OpenProject instance. - -## How can I log into the app? - -You can log in using your OpenProject Cloud account or your username and password for your On-Premises instance. Please ensure: - -- Your instance has a **valid HTTPS certificate**. -- **Built-in OAuth applications are enabled** in your instance administration settings (`{BASE_URL}/admin/oauth/applications`). -- Your instance is on **OpenProject version 17.0.0 or higher**, or the “OAuth Authentication” feature flag is enabled under **Administration → Experimental** for older instances. - -## What can I do in the Home Dashboard? - -The Home Dashboard provides a **personalized overview** of your work and includes the following widgets: - -- **Notifications**: See recent mentions, comments, and updates. -- **Time Tracker**: Start or resume focus-mode timers. -- **Favorite Projects**: Quick access to starred projects. -- **Week Time Tracking**: Overview of logged hours for the current week. -- **Portfolios**: Snapshot of portfolio-level progress. -- **Assigned to Me**: List of work packages assigned to you. -- **Recently Viewed**: Quick access to recently opened items. - -[Learn more about Home Dashboard in the OpenProject mobile app](../core-features/home-dashboard/). - -## How does the Projects module work? - -The Projects module provides an **index of all portfolios, programs, and projects**. Users can: - -- Navigate the **hierarchy** between portfolios, programs, and projects. -- Filter the list to show only **favorites**. -- Open any item to see: - - **Overview tab**: Description, status, and attributes - - **Work Packages tab**: List of associated tasks - - **Child Projects/Programs tab**: Projects or programs under the selected item - -[Learn more about Projects module in the OpenProject mobile app](../core-features/projects/). - -## What can I do in Work Packages? - -The Work Packages module supports: - -- Viewing and filtering all open work packages -- Searching by keywords -- Editing work package details and custom fields -- Creating new work packages (quick creation or full attribute entry) -- Adding comments, mentions, and images in the **Activity** tab -- Uploading files or photos directly from the camera -- Managing **relations** and **watchers** -- Logging time or starting a timer for focused work -- Setting reminders -- **Sharing work packages** using the device’s native sharing options - -[Learn more about Work Packages module in the OpenProject mobile app](../core-features/work-packages/). - -## How does Time Tracking work? - -The Time Tracking module allows you to monitor and log your work efficiently: - -- **Time Entries Index**: View current and past weeks and their logged time entries. -- **Timer Focus Mode**: Track work in real time with a background timer. -- **Log Time**: Record time spent on specific work packages manually. - -[Learn more about Time Tracking in OpenProject mobile app](../core-features/time-tracking/). - -## How do notifications work? - -The Notification Center collects updates from your projects. Users can: - -- View all new notifications from OpenProject. -- Open a notification to see the associated work package in the **Activity tab**. -- Mark individual notifications or all notifications as read. -- Switch between notification queries to filter by participation, mentions, or other custom inboxes. -- Toggle between viewing only unread or all notifications. - -[Learn more about Notifications in OpenProject mobile app](../core-features/notification-center/). - -## What settings can I configure in the app? - -Through the **User Settings** module, users can: - -- Change the **default launch page** -- Switch **color mode** (light, dark, system default) -- Change the app **language** -- Enable or disable specific **features** (e.g., hide Time Tracking module) -- Update **personal details** (name, email, etc.) -- Configure **notification settings** and deactivate OS-level notifications -- Provide **feedback** directly to the OpenProject Community project - -[Learn more about configuring user settings in OpenProject mobile app](../core-features/user-settings/). - -## Are all OpenProject features available in the mobile app? - -No. The mobile app is a **companion app** and is currently in Beta status. Some advanced features of the web or desktop versions are not yet available, including: - -- Deep-linking to On-Premises instances -- Multi-device UI synchronization -- Real-time push notifications -- Writing internal comments across multiple work packages -- Viewing meeting agendas in the app - -These features are planned for future releases. - -## What should I do if I experience login issues? - -Check the following: - -- Your instance supports **HTTPS** and is reachable from your device. -- Built-in OAuth applications are **enabled** in your instance administration. -- Your instance meets the **minimum version** requirement (17.0.0), or the OAuth feature flag is enabled. -- Ensure your credentials are correct, and you have **API access** enabled on On-Premises instances. - -If none of the above solves the problem, check the [Login Troubleshooting Guide](../first-steps/login-troubleshooting/). - -## How can I provide feedback on the Beta app? - -Feedback can be submitted directly through the **User Settings → Feedback** section. Submitted feedback is sent to the OpenProject Mobile App team, allowing us to review and incorporate user suggestions. - -## Can I use the app offline? - -The app requires an **active internet connection** to sync data with your OpenProject instance. Some previously loaded data may be viewable offline, but creating work packages, logging time, or updating tasks requires connectivity. diff --git a/docs/mobile-app-guide/first-steps/README.md b/docs/mobile-app-guide/first-steps/README.md index 3dcd8bdd206a..e4a9d16ffab7 100644 --- a/docs/mobile-app-guide/first-steps/README.md +++ b/docs/mobile-app-guide/first-steps/README.md @@ -1,69 +1,32 @@ --- sidebar_navigation: - title: "First Steps: Access, Download, and Log In" - priority: 800 -description: Follow these steps to install and start using the OpenProject Mobile App (Beta). + title: Get started + priority: 890 +description: Follow these steps to install, log in, and start using the OpenProject Mobile app (Beta). keywords: mobile app first steps, getting started, log in, log-in, login, mobile log in, openproject mobile app, download, access, install, mobile installation --- -# First Steps: Access, Download, and Log In +# Get started -Follow these steps to install and start using the **OpenProject Mobile App (Beta)**: +This section helps you install the OpenProject Mobile app (Beta) and log in to your OpenProject instance. -## Check the Requirements +## Start here -Before downloading the app, please ensure your environment meets the following prerequisites: +| Feature | Description | +| --- | --- | +|[ **Install and log in**](install-login) | Download the app for iOS or Android, check the requirements, and sign in with your OpenProject credentials. | +|[**Login troubleshooting**](login-troubleshooting) | If login fails, follow a step-by-step checklist to verify the OpenProject version, HTTPS and certificates, and OAuth settings. | -- **An active OpenProject account:** Either from an **OpenProject Cloud** workspace or an **OpenProject On-premises** installation with API access enabled. -- A **signed certificate** (**https** not http) on your instance to be able to log in. -- **Minimum OpenProject version:** 17.0.0 +## Quick requirements overview -> [!NOTE] -> If you have a previous version of OpenProject you can connect your OpenProject instance by asking your administrator to enable the Built in OAuth applications flag under `_{BASE_URL}/admin/settings/experimental_`. +To use the OpenProject Mobile app (Beta), you need: -- **Minimum system requirements:** - - **iOS 17** or later - - **Android 12** or later -- **Built-in OAuth applications enabled:** Make sure that the built-in OAuth applications are **enabled in your administration settings** (`{BASE_URL}/admin/oauth/applications`). This is required for successful login from the mobile app. -![Applications setting to enable the built-in OAuth in OpenProject](mobile_app_oauth_authentication.png) -- **Network connection:** Internet access is required for syncing data with your OpenProject instance. +- **OpenProject 17.0.0 or above** +- An **OpenProject Cloud** workspace or **on-premises** installation (with API access enabled) +- **HTTPS with a signed certificate** (http is not supported) +- **Built in OAuth applications enabled**: `{BASE_URL}/admin/oauth/applications` +- **iOS 17+** or **Android 12+** +- Internet access for syncing > [!NOTE] -> Some features, such as deep-linking and real-time push notifications, may depend on your organization’s configuration or will become available in future updates. - -## Download the App - -The **OpenProject Mobile App** is available for both major platforms: - -- **iOS:** [App Store link](https://apps.apple.com/us/app/openproject/id6474431879). -- **Android:** [Google Play link](https://play.google.com/store/apps/details?id=org.openproject.app&hl=en). - -Search for **“OpenProject”** in your app store, or use the direct links above to download the app. - -## Open the App - -After installation, open the app on your device. You’ll be greeted with a **short onboarding** on the app features and then prompted to **log in** to your OpenProject instance. -![Initial onboarding page of the OpenProject mobile app](mobile-app-onboarding.png) - -## Choose Your Instance - -Enter the complete **base URL** of your instance (for example, `https://yourcompany.openproject.com`). -![Mobile app initial onboarding page](mobile-app-login-instance.png) - -## Log In with Your Credentials - -- Once your instance is confirmed, log in using your **OpenProject username and password** in the browser modal that opened. -![Mobile app browser sign in screen](mobile-app-browser-sign-in.png) - -- The app will ask you for a permission to have full access to the **OpenProject API v3** to authorize your account and securely connect to your workspace. -![OpenProject mobile app browser API v3 authorization screen](mobile-browser-oauth-authorization.png) - -## Start Exploring - -You’re all set! Once logged in, you can: - -- View and edit **work packages** -- **Comment** and reply to discussions -- **Create** and track work packages easy and fast -- **Log time** and run focus **timers** -- Stay updated with **local notifications** +> If you have an earlier OpenProject version, an administrator may need to enable the **Built in OAuth applications** flag under `{BASE_URL}/admin/settings/experimental`. \ No newline at end of file diff --git a/docs/mobile-app-guide/first-steps/install-login/README.md b/docs/mobile-app-guide/first-steps/install-login/README.md new file mode 100644 index 000000000000..a4f6a2a82df1 --- /dev/null +++ b/docs/mobile-app-guide/first-steps/install-login/README.md @@ -0,0 +1,74 @@ +--- +sidebar_navigation: + title: Install and log in + priority: 790 +description: Follow these steps and requirements to start using the OpenProject Mobile app. +keywords: mobile app first steps, getting started, log in, log-in, login, mobile log in, openproject mobile app, download, access, install, mobile installation +--- + +# Install and log in + +Follow these steps to install and start using the **OpenProject Mobile app**. + +## 1) Check the requirements + +Before downloading the app, ensure your setup meets these prerequisites: + +- **An active OpenProject account:** Either an **OpenProject Cloud** workspace or an **OpenProject on-premises** installation with API access enabled. +- **HTTPS with a signed certificate (required):** Your instance must use **https** (not http) with a **signed certificate** to log in. +- **Minimum OpenProject version:** **17.0.0** +- **Minimum system requirements** + - **iOS:** 15 or later + - **Android:** 12 or later +- **Built-in OAuth applications enabled:** Make sure built-in OAuth applications are enabled in your administration settings:`{BASE_URL}/admin/oauth/applications`. This is required for successful login from the mobile app. + +![OAuth setting on the desktop core app to enable the app authentication flow](install_login-desktop_setting_oauth.png) + +> [!NOTE] +> If you have an earlier OpenProject version, an administrator may need to enable the **Built in OAuth applications** flag under `{BASE_URL}/admin/settings/experimental`. + +## 2) Download the app + +The OpenProject Mobile app is available for both major platforms: + +- **iOS:** [**App Store link**](https://apps.apple.com/us/app/openproject/id6474431879). +- **Android:** [**Google Play link**](https://play.google.com/store/apps/details?id=org.openproject.app&hl=en). + +You can also search for **“OpenProject”** in your device’s app store. + +## 3) Open the app + +After installation: + +1. Open the app on your device. +2. Review the short onboarding introduction. +3. Proceed to the login screen to connect to your OpenProject instance. + +![Onboarding page on the OpenProject mobile app](install_login-oboarding.png) + +## 4) Choose your instance + +Enter the complete **base URL** of your OpenProject instance, for example: `https://yourcompany.openproject.com` + +![Login page on the OpenProject mobile app](install_login-instance_url.png) + +## 5) Log in with your credentials + +1. After your instance is confirmed, log in using your **OpenProject username and password** in the browser modal that opens. + +![Browser pop-up that opens to enter your login credentials](install_login-login.png) + +2. When prompted, allow access so the app can connect securely to your workspace via the **OpenProject API v3**. + +![Browser pop-up to authenticate the app to the core API](install_login-authorization.png) + +## 6) Start exploring + +Once you’re logged in, you can start using key mobile workflows, including: + +- View and edit **work packages** +- **Comment** and reply to discussions +- Organise your work in your own **home dashboard** +- Check all your work **projects** and spaces +- Create and track **meetings** quickly +- **Log time** and run focus **timers** \ No newline at end of file diff --git a/docs/mobile-app-guide/first-steps/install-login/install_login-authorization.png b/docs/mobile-app-guide/first-steps/install-login/install_login-authorization.png new file mode 100644 index 000000000000..ab71c345d670 Binary files /dev/null and b/docs/mobile-app-guide/first-steps/install-login/install_login-authorization.png differ diff --git a/docs/mobile-app-guide/mobile_app_oauth_authentication.png b/docs/mobile-app-guide/first-steps/install-login/install_login-desktop_setting_oauth.png similarity index 100% rename from docs/mobile-app-guide/mobile_app_oauth_authentication.png rename to docs/mobile-app-guide/first-steps/install-login/install_login-desktop_setting_oauth.png diff --git a/docs/mobile-app-guide/first-steps/install-login/install_login-instance_url.png b/docs/mobile-app-guide/first-steps/install-login/install_login-instance_url.png new file mode 100644 index 000000000000..a029ab147bd8 Binary files /dev/null and b/docs/mobile-app-guide/first-steps/install-login/install_login-instance_url.png differ diff --git a/docs/mobile-app-guide/first-steps/install-login/install_login-login.png b/docs/mobile-app-guide/first-steps/install-login/install_login-login.png new file mode 100644 index 000000000000..6c9a2aba7aa9 Binary files /dev/null and b/docs/mobile-app-guide/first-steps/install-login/install_login-login.png differ diff --git a/docs/mobile-app-guide/first-steps/install-login/install_login-oboarding.png b/docs/mobile-app-guide/first-steps/install-login/install_login-oboarding.png new file mode 100644 index 000000000000..a580aa88918b Binary files /dev/null and b/docs/mobile-app-guide/first-steps/install-login/install_login-oboarding.png differ diff --git a/docs/mobile-app-guide/first-steps/login-troubleshooting/README.md b/docs/mobile-app-guide/first-steps/login-troubleshooting/README.md index 3f856e1e53a6..96a26db41030 100644 --- a/docs/mobile-app-guide/first-steps/login-troubleshooting/README.md +++ b/docs/mobile-app-guide/first-steps/login-troubleshooting/README.md @@ -1,7 +1,7 @@ --- sidebar_navigation: title: Login Troubleshooting - priority: 700 + priority: 780 description: Resolve the most common issues logging in to the OpenProject Mobile app. keywords: Mobile App Login Troubleshooting, log in error, mobile app troubleshooting, mobile app error --- diff --git a/docs/mobile-app-guide/first-steps/mobile-app-browser-sign-in.png b/docs/mobile-app-guide/first-steps/mobile-app-browser-sign-in.png deleted file mode 100644 index 9763e280db25..000000000000 Binary files a/docs/mobile-app-guide/first-steps/mobile-app-browser-sign-in.png and /dev/null differ diff --git a/docs/mobile-app-guide/first-steps/mobile-app-login-instance.png b/docs/mobile-app-guide/first-steps/mobile-app-login-instance.png deleted file mode 100644 index 4a0938dae571..000000000000 Binary files a/docs/mobile-app-guide/first-steps/mobile-app-login-instance.png and /dev/null differ diff --git a/docs/mobile-app-guide/first-steps/mobile-app-onboarding.png b/docs/mobile-app-guide/first-steps/mobile-app-onboarding.png deleted file mode 100644 index 56fdf52f4d84..000000000000 Binary files a/docs/mobile-app-guide/first-steps/mobile-app-onboarding.png and /dev/null differ diff --git a/docs/mobile-app-guide/first-steps/mobile-browser-oauth-authorization.png b/docs/mobile-app-guide/first-steps/mobile-browser-oauth-authorization.png deleted file mode 100644 index d3aed7dcd6dd..000000000000 Binary files a/docs/mobile-app-guide/first-steps/mobile-browser-oauth-authorization.png and /dev/null differ diff --git a/docs/mobile-app-guide/first-steps/mobile_app_oauth_authentication.png b/docs/mobile-app-guide/first-steps/mobile_app_oauth_authentication.png deleted file mode 100644 index 9547f031f833..000000000000 Binary files a/docs/mobile-app-guide/first-steps/mobile_app_oauth_authentication.png and /dev/null differ diff --git a/docs/mobile-app-guide/help-reference/README.md b/docs/mobile-app-guide/help-reference/README.md new file mode 100644 index 000000000000..5f5f0ed28664 --- /dev/null +++ b/docs/mobile-app-guide/help-reference/README.md @@ -0,0 +1,24 @@ +--- +sidebar_navigation: + title: "Help and reference" + priority: 860 +description: Get help and references when you are stuck with the OpenProject mobile app. +keywords: mobile app help, support, help, app help, faq, mobile app support, OpenProject mobile app +--- + +# Help and reference + +The OpenProject mobile app includes several ways to help you get unstuck, understand features, and learn what to expect while the app continues to evolve. + +This section is the entry point for: + +- **Self-service help** (how things work, common questions) +- **Reference information** (known gaps and limitations, especially during beta phases) +- Guidance on where to go when something does not behave as expected + +## Where to find the information + +| Feature | Description | +| --- | --- | +|[**Mobile app FAQ**](faq) | Common questions and answers about using the app day to day. | +|[**Known limitations (beta)**](known-limitations) | A transparent list of current limitations and missing functionality to be aware of while the mobile experience is still evolving. | diff --git a/docs/mobile-app-guide/help-reference/faq/README.md b/docs/mobile-app-guide/help-reference/faq/README.md new file mode 100644 index 000000000000..9aae471b35da --- /dev/null +++ b/docs/mobile-app-guide/help-reference/faq/README.md @@ -0,0 +1,199 @@ +--- +sidebar_navigation: + title: Mobile app FAQ + priority: 790 +description: FAQ of the OpenProject Mobile app. +keywords: Mobile app FAQ, faq, mobile app questions, OpenProject mobile app +--- + +# Mobile app FAQ + +## Why is the OpenProject Mobile App being released in a Beta state? + +The app is released in **Beta** to provide early access while core functionality is still under development. This allows the OpenProject team to gather **feedback from real users**, identify issues, and improve the experience before a full public release. + +## What is the OpenProject Mobile app? + +The OpenProject Mobile app is a companion to the OpenProject web and desktop applications. It helps you **stay informed, manage work packages, track time, and collaborate** while on the go. As the app is currently in **Beta**, some advanced features are still under development. + +## What platforms are supported? + +- **iOS 17 or later** +- **Android 12 or later** + +The app requires an **active internet connection** to sync data with your OpenProject instance. + +## How can I log in to the app? + +The app requires an **active internet connection** at login to sync data with your OpenProject instance. You can log in using your username and password. Please ensure: + +- Your instance has a **valid HTTPS certificate**. +- **Built-in OAuth applications are enabled** in your instance administration settings (`{BASE_URL}/admin/oauth/applications`). +- Your instance is on **OpenProject version 17.0.0 or higher**, or the “OAuth Authentication” feature flag is enabled under **Administration → Experimental** for older instances. + +## What can I do in the Home Dashboard? + +The Home dashboard provides a **personalized overview** of your work and includes widgets such as: + +- **Notifications** +- **Time tracker** +- **Favorite projects/spaces** +- **Week time tracking** +- **Portfolios** (if configured) +- **Assigned to me** +- **Recently viewed** + +Depending on your device, many of these widgets may also be available as **OS widgets** on your phone’s home screen. + +[Learn more about Home Dashboard in the OpenProject mobile app](../../core-features/home-dashboard/). + +## How does the Spaces module work? + +The **Spaces** module (formerly Projects) provides an index of the spaces/projects you can access. Depending on your setup, it can also display a hierarchy (for example, portfolios → programs → projects). You can: + +- Browse the list and navigate hierarchies (if enabled) +- Filter (e.g., by type) +- Switch between **All** and **Favorites** +- Open a space to view its overview and work packages + +[Learn more about Spaces in the OpenProject mobile app](../../core-features/projects/). + +## What can I do in Work Packages? + +The Work packages module supports: + +- Viewing and filtering work packages +- Searching by keywords +- Viewing details (Overview, Activity, Files, Relations, Watchers) +- Editing fields supported by the mobile app (depending on configuration and permissions) +- Creating new work packages from the list (via **+**) +- Collaboration via the **Activity** tab and watchers +- More actions such as sharing, time tracking, adding to device calendar, and reminders (depending on platform/version) + +[Learn more about the Work Packages module in the OpenProject mobile app](../../core-features/work-packages/). + +## How does Time Tracking work? + +The Time tracking module helps you review and log time from the mobile app. It includes tabbed views: + +- **Day**: review logged time by day +- **Work week**: weekly overview and totals +- **Time tracker**: run a timer and link it to a work package + +You can also log time for **other users** (and even **multiple users at once**) if you have permission. + +> [!IMPORTANT] +> The time entries displayed in the app are **personal only**. Entries for other users are not shown in the app even if you logged them. + +[Learn more about Time Tracking in the OpenProject mobile app](../../core-features/time-tracking/). + +## How do notifications work? + +The **Notifications** module collects updates from your projects/spaces. You can: + +- View notifications in different **queries** (selected from the top header), such as Inbox, Mentioned, Assignee, Watcher, Date alert, etc. +- Toggle between **Unread** and **All** +- Open a notification to view it in context (usually in the work package’s **Activity** tab) +- Mark notifications as read + +You can also adjust: + +- what you receive notifications for (**Account and settings → Notification settings**) +- when activity is marked as read (e.g., on opening Activity, on commenting, or on quote reply—depending on your available options) + +[Learn more about Notifications in OpenProject mobile app](../../core-features/notification-center/). + +## What can I do in Meetings? + +The **Meetings** module lets you manage both **one-time meetings** and **recurring meeting series**. In the mobile app, you can: + +- See all meetings (individual meetings and meeting series) +- Browse **upcoming** and **past** meetings within a series +- Search and filter meetings (e.g., by project or query) +- Open meeting details, including: + - **Agenda** + - **Backlog** + - **Details** + - **Participants** + - **Attachments** +- Update the meeting status +- Prepare and manage the agenda: + - add/edit/move/delete agenda sections and items + - link work packages to agenda items +- Add and edit outcomes while a meeting is in progress +- Create new meetings (one-time) or new recurring meeting series +- Delete or cancel meetings (depending on permissions and configuration) +- View linked meetings from a work package via the **Meetings** tab + +[Learn more about Meetings in the OpenProject mobile app](../../core-features/meetings/). + +## What settings can I configure in the app? + +In **Account and settings**, you can manage: + +- Basic account information (avatar, username, name, email — depending on what is editable) +- Personalization (launch page, enabled modules, language, theme) +- Notification settings +- Work package settings (Activity “mark as read”, creation defaults, default list page) +- Crash reports (opt-in) +- Give feedback (bug/feedback/feature request, attachments, follow-up email) +- What’s new +- Link to mobile app documentation +- Switch instance +- Sign out + +[Learn more about configuring user settings in the OpenProject mobile app](../../core-features/user-settings/). + +## Are all OpenProject features available in the mobile app? + +No. The app is a **companion app** and is currently in Beta. Some web/desktop capabilities are not available yet and will be added over time. + +## What should I do if I experience login issues? + +Check the following: + +- Your instance supports **HTTPS** and is reachable from your device. +- Built-in OAuth applications are **enabled** in your instance administration. +- Your instance meets the **minimum version** requirement (17.0.0), or the OAuth feature flag is enabled. +- Ensure your credentials are correct and that you have **API access** enabled on On-Premises instances. + +If none of the above solve the problem, check the [Login Troubleshooting Guide](../../first-steps/login-troubleshooting/). + +## How can I provide feedback on the Beta app? + +Use **Settings and support → Give feedback** to submit bug reports, feedback, or feature requests (including attachments). This goes directly to the mobile app team. + +## Can I use the app offline? + +The app requires an **active internet connection** to sync. Some previously loaded content may remain visible, but creating and updating items generally requires connectivity. We are currently working on bringing offline capabilities to the app, and we hope we will be able to offer these soon. + +## How can I switch between multiple OpenProject instances? + +Use **Settings and support → Switch instance** to switch between instance URLs without signing out each time. + +## Why can’t I find a project/space, work package, meeting, or user? + +The app only shows content you are allowed to access. If something is missing, it is usually due to: + +- missing permissions in that project/space, +- the item being outside the currently selected filters (e.g., “All open”), +- or the feature not being supported in the current mobile version. + +## Why don’t I see time entries for other users in the app? + +Even if you logged time for other users, the Time tracking views show **only your personal time entries**. Other users’ time entries are not displayed. + +## Can I search across my whole instance? + +Yes. Use **Global search** to search across supported types (currently, **Work packages** and **Spaces/Projects**). Meetings are planned to be added in a future update. + +## Is there a dedicated desktop app? + +Not yet. On macOS, a scaled-up iPad version may be available via the App Store, but it’s not designed for desktop usage and should be used with caution. Desktop support improvements are planned. + +## Why do I receive too many notifications (or miss some)? + +Check **Settings and support → Notification settings** to configure: + +- Which notification types you receive (participation, date alerts, etc.) +- How Activity items are marked as read (so notifications aren’t cleared too early—or aren’t left unread longer than you want). \ No newline at end of file diff --git a/docs/mobile-app-guide/help-reference/known-limitations/README.md b/docs/mobile-app-guide/help-reference/known-limitations/README.md new file mode 100644 index 000000000000..a37db845d644 --- /dev/null +++ b/docs/mobile-app-guide/help-reference/known-limitations/README.md @@ -0,0 +1,53 @@ +--- +sidebar_navigation: + title: Known limitations (beta) + priority: 780 +description: Known limitations of the current mobile app in Beta. +keywords: Mobile app limitations, beta, beta limitations, modules, features, OpenProject mobile app +--- + +# Known limitations (beta) + +The OpenProject mobile app is currently released as a **Beta**. This means the core experience is available, but some capabilities are not yet supported or are still evolving. + +This page lists the most important limitations to be aware of. + +## Connectivity and offline use + +- **Offline mode is not supported.** The app requires an active internet connection to load and sync content. +- Some content you recently opened may remain visible temporarily, but actions such as creating or updating items generally require connectivity. + +## Notifications + +- **Real-time push notifications are not available yet.** + - You can still view notifications inside the app in **Notifications**. + - If you rely on immediate alerts, you may need to check the app manually for updates. + +## Deep linking + +- **Deep linking is not supported yet**, meaning links that should open directly in the mobile app may open in a browser instead (or not resolve to the corresponding in-app screen). + +## Feature coverage vs. web/desktop + +The mobile app is a companion to the web/desktop application. Some advanced functionality available on the desktop is not yet available on mobile. + +Common examples include: + +- Not every module or feature from the web application is available in the mobile app yet. +- Most administrative or configuration actions may require using the web application. + +## Search scope + +- **Global search is limited to selected content types.** + - Currently supported: **Work packages** and **Spaces/Projects**. + - **Meetings** are planned but not fully available through global search yet. + - New modules will be included in the search scope as they are developed. + +## Desktop usage + +- There is **no dedicated desktop app** for OpenProject Mobile. +- On macOS, a scaled-up iPad version may be available via the App Store, but it is not designed for desktop workflows and should be used with caution. + +## Feedback + +- If you run into an issue, please use **Settings and support → Give feedback** to report it (ideally with screenshots and steps to reproduce). \ No newline at end of file diff --git a/docs/mobile-app-guide/mobile_app_feedback_flow_entrypoint.png b/docs/mobile-app-guide/mobile_app_feedback_flow_entrypoint.png deleted file mode 100644 index 14023a5e8c6d..000000000000 Binary files a/docs/mobile-app-guide/mobile_app_feedback_flow_entrypoint.png and /dev/null differ