You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The Red Brick Road (RBR) and Green Brick Road (GBR) are each a method to direct a user down a clear path of actions to take or errors to fix. It is intended to help the user have a clearly defined set of steps to follow in order to resolve something. It can lead you to take an action anywhere in the Inbox, Reports, Workspaces, or Account.
3
+
4
+
## Terminology
5
+
-**Brick Road**: The Brick Road is named after the Yellow Brick Road from the popular movie The Wizard of Oz. In the Wizard of Oz, Dorothy must follow the Yellow Brick Road in order to reach the Emerald City, similar to how the Brick Roads in Expensify lead the user down a certain path to reach the final destination of a resolution.
6
+
-**Red Brick Road**: The Red Brick Road (RBR) is the red dot that shows up under certain conditions that will lead the user down a path of errors or violations to fix.
7
+
-**The UI Pattern**:
8
+
- The Red Brick Road will show up in the UI as a red dot next to an inbox item, expense, report or other specific menu item.
9
+
- The goal is to bring the user to some kind of action.
10
+
- With the RBR, it usually ends at some kind of error with instructions on how to fix it.
11
+
- The dots (or indicators) should be present on the navigation items (eg. links, buttons) that the user needs to click on to take them to where the action item will be.
12
+
The dots (or indicators) should be present on the navigation items (eg. links, buttons) that the user needs to click on to take them to where the action item will be
13
+
-**Green Brick Road**: The Green Brick Road (GBR) is the red dot that shows up under certain conditions that will lead the user down a path of errors or violations to fix.
14
+
-**The UI Pattern**:
15
+
- The Green Brick Road will show up in the UI as a green dot next to an inbox item, expense, report, or other specific menu item.
16
+
- The goal is to bring the user to some kind of action.
17
+
- With GBR, it's usually a big green button to signal they made it to the end of the road.
18
+
- The dots (or indicators) should be present on the navigation items (eg. links, buttons) that the user needs to click on to take them to where the action item will be.
19
+
-**Both Brick Roads**
20
+
-**The UI Pattern**:
21
+
- For both Brick Roads, it MUST take the user to something that is actionable. If there is nothing the user can do to resolve the brick road, then the brick road should not exist.-
22
+
23
+
## Green Brick Road (GBR)
24
+
This section is broken down into the rules and examples for each section where the Green Brick Road will appear.
25
+
26
+
### Rules
27
+
The GBR MUST show up when there is a pending action to take or item to review.
28
+
29
+
### Inbox
30
+
Any chats in the left hand navigation (LHN) that require attention will in most cases show up in the highest context chat.
31
+
Examples:
32
+
- There is a report pending approval by an admin
33
+
- There is a report pending submission by an employee
34
+
- There is a report waiting to be paid by the admin
35
+
- There is a report queued for reimbursement but the employee needs to add a deposit bank account
36
+
- An Expensify Card has been issued to an employee but the employee needs to add their shipping details
37
+
- A user is mentioned in a report comment
38
+
39
+
### Workspaces
40
+
Examples:
41
+
- If the billing owner had to retry billing and the retry was successful
42
+
43
+
### Account
44
+
Examples:
45
+
- A user has an unvalidated contact method
46
+
47
+
48
+
## Red Brick Road (RBR)
49
+
This section is broken down into rules and examples for each section where the Red Brick Road will appear.
50
+
51
+
### Rules
52
+
The RBR MUST show up when there is an error or violation that needs fixing.
53
+
54
+
### Inbox
55
+
Any chats in the left hand navigation (LHN) that require attention will in most cases show up in the highest context chat.
56
+
Examples:
57
+
- There are violations on a report that the employee needs to fix
58
+
- There is a task that you assigned to an employee waiting to be completed
59
+
- There is an expense that the admin put on hold
60
+
61
+
### Workspaces
62
+
Examples:
63
+
- The Workspace Admin's accounting integration connection is broken
64
+
- The QuickBooks Online export is broken and needs to be re-authenticated
65
+
- Your direct connection to your bank or Plaid is broken and needs to be reconnected
66
+
- There is an error with your billing subscription
67
+
- The Workspace Admin adds a new workspace member but gets an error message
68
+
69
+
### Account
70
+
Examples:
71
+
- A third party card assigned to a user has a broken connection
72
+
73
+
### Other
74
+
Examples:
75
+
- There is an error that occurred from an action the user took while they were offline
0 commit comments