# Feature OP-11597 - "Lists" module to replace "Work packages" with filtered or manual lists

Project: OpenProject
Status: in specification
URL: https://community.openproject.org/work_packages/OP-11597

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | Wish List |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | Yes |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee | Parimal Satyal |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers |  |
| Designer | Parimal Satyal |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As a** project member,   
**I want to** be able to create both manual lists (pick work packages myself) and filtered ones (as I can today with views)  
**so that** I have full freedom of how I organise my lists of work packages, and am no longer confused with the name "Work package" for the module, since I can really access my work packages from a number of other modules (like boards, team planner or calendar).

### Note

*This UX optimisation to the work packages module is not yet roadmapped. This feature exists so we can discuss and go through iterations before we're able to determine when we might implement it.*

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/42423/content">

### Related

This feature requires updates to the sidebar menu, which are handled by \#xxx (to be created).

### Acceptance Criteria

**Lists, starring and public/private**

  - The current work package module is renamed "Lists".
  - There are two types of lists.
      - "Filtered" (a list of work packages based on filter criteria, are similar to the current *Views*)
      - "Manual" (a basic list of work packages that users can add and remove manually)
  - There are two new header labels (to the right of the name of the list), for both list types:
      - Private/Public (clicking this opens the Visibility settings modal)
      - Stared/Unstarred (clicking this toggles starred/unstarred)
  - The notion of "Favorite" is replaced by "starred".
      - Starring are and unstarring something is as simple as clicking on the star next to the name of the list
      - Starring is a private action; it only changes the value for that user.
      - Starring puts that list on the top of its respective category (in alphabetical order)
      - Lists can be starred/unstarred; the position in the sidebar will change immediately.
      - This is also indicated in the sidebar (a star icon next to the name)
  - All lists can either be public or private (as is the case today)
      - Private lists have a lock icon next to them in the sidebar
  - Each list has an icon to the left of the name that represents the list type: filtered or manual.
      - This is the same icon as used in the sidebar headers for each type.
  - The current sidebar categories ("Favorite", "Default", "Public", "Private") are replaced by just two categories: "Filtered" and "Manual"
      - Each sidebar header has an icon associated with it.
      - What were previously"default" views are now public filtered views that are starred by default (the user is free to unstar them if a default view isn't very important to them; this does not change the view for anyone else)
      - What were previously "favorite" views are now also simply starred views.
      - The distinction between favorite and default views no longer exist; default views are simply public views that exist by default. *- Note: Default lists like "Created by me", "Recent activity" might eventually be replaced by quick search filters (feature being designed in parallel).*
  - Private views can be deleted, but public views cannot.

**Creating new lists**

  - There is a new "+ List"button at the buttom of the sidebar (inside the Lists module, similar to Team planner, Boards and Calendar)
  - Clicking on this displays a modal (similar to Board selection) with two options that are selectable: Filtered and Manual.
      - The modal title is: "Create a new list"
      - The modal body text is: "Select the type of list you would like to create:"
      - Option 1 is titled "Filtered (automatic)" and is in *Subheader Small/Bold*
          - The description text is *in Body Small/Regular*: "An automatically-generated list that displays items that meet criteria you define."
      - Option 2 is titled "Manual (hand-picked)" and is in *Subheader Small/Bold*
          - The description text is *in Body Small/Regular*: "A custom list of items you manually add and remove. Filtering is not possible."
  - The action bar has two actions: "Cancel" (secondary) and "Create" (primary).
      - Until an option is selected, the "Create" button is disabled. It is activated by a selection.
  - The create button creates a new list of the selected type.
  - The actions offered in the header (on the right edge) differ from one type to the other:
      - A manual list has:
          - \+ Add
          - Table|Cards|Gantt dropdown
          - Info (open in split-screen)
          - Zen mode (full screen)
          - More
      - A filtered list has:
          - Include projects
          - Filter
          - Table|Cards|Gantt dropdown
          - Info (open in split-screen)
          - Zen mode (full screen)
          - More
  - When a new filtered list is created:
      - The filter panel is open by default.
      - The work package table contains all work packages for that current project (same as "All open")
  - When a new manual list is created:
      - The work package table is empty.

**Adding or removing items in a manual list**

  - In manual lists, there is a single link at the bottom of the list to add new items.
  - The link has an *add* (+) left icon and an "Add item" label
      - Clicking on this link adds a new line to the list with a text field spanning the length of the table row.
      - The text field is focused.
      - The placeholder text is: "Type subject to create new or use \# to search for existing".
      - The user can simply start typing something and hitting enter will create a new work package with the input text as the subject. (The type, status and project are pre-filled by default as it is today).
      - The user can alternatively start with the character "\#" to go into search mode, and then type a search keyword or a work package id.
          - The results are displayed in a dropdown (the same as in the relations tab).
          - Clicking on a result adds that work package to the list.
      - After a work package has either be added or created (after pressing enter), a new line is added to the list so that the user may add or create a new work package.
          - Hitting escape removes this new line.
  - This behaviour is also possible in just one Filtered list: "All Open"

### Open questions

  - I've suggested the term "item" to replace "work packages".
      - What do we think about it? Better alternatives? Translations?
      - How does it co-habit with work packages, which we'll surely be using as well in places where "item" doesn't quite make sense (and because we surely won't be able to change everything in one go)
  - For a new manual work package, should the focus directly be on an initialised new line? (That is, without the user needed to click on "+ Add item")

### Visuals

**A saved but empty manual list, with the focus on a new line:**

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/42424/content">

**Using the \# character with a search term to add an existing work package:**

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/42428/content">

**A new filtered list with the filter panel open:**

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/42429/content">

**Clicking on the + List button on the bottom of the sidebar lets users pick between two list types:**

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/42427/content">

### Out of scope

  - The ability to access these lists from elsewhere (like the Team planner)
  - The ability to add work packages to existing or new lists via the work package detailed or split-screen viwe
  - Named presets for filtered views (such as "Unassigned tasks", "My recent activity", "Tasks due this week")
  - Redesigning/improving how saving lists works

### Figma mockup

<https://www.figma.com/file/jyvSW0J7ZduLzC9gfJ5oYK/Lists-(Filtered-and-Manual)?node-id=676%3A39125>
