> For the complete documentation index, see [llms.txt](https://docs.appflowy.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appflowy.io/docs/documentation/software-contributions/architecture/frontend/folder/events.md).

# Events & Notifications

Events are used in the [communication](https://appflowy.gitbook.io/docs/essential-documentation/contribute-to-appflowy/architecture/frontend/inter-process-communication) between the frontend and the backend. If you interested in the process about generating the events files, please check [this](https://appflowy.gitbook.io/docs/essential-documentation/contribute-to-appflowy/architecture/backend/event) out.

This document explains the events and notifications defined in the Folder scope.

## Events

| FolderEvent          |                                                                   |
| -------------------- | ----------------------------------------------------------------- |
| CreateWorkspace      | Create a new workspace                                            |
| ReadCurrentWorkspace | Read the current opening workspace                                |
| OpenWorkspace        | Open the workspace and mark it as the current workspace           |
| ReadWorkspaceApps    | Return a list of apps that belong to this workspace               |
| CreateApp            | Create a new app                                                  |
| DeleteApp            | Delete the app                                                    |
| ReadApp              | Return the app info                                               |
| UpdateApp            | Update the app's properties including the name,description, etc.  |
| CreateView           | Create a new view in the corresponding app                        |
| ReadView             | Return the view info                                              |
| UpdateView           | Update the view's properties including the name,description, etc. |
| DeleteView           | Move the view to the trash folder                                 |
| DuplicateView        | Duplicate the view                                                |
| CloseView            | Close and release the resources that are used by this view        |
| SetLatestView        | Set the current visiting view                                     |
| MoveItem             | Move the view or app to another place                             |
| ReadTrash            | Read the trash that was deleted by the user                       |
| PutbackTrash         | Put back the trash to the origin folder                           |
| DeleteTrash          | Delete the trash from the disk                                    |
| RestoreAllTrash      | Put back all the trash to its original folder                     |
| DeleteAllTrash       | Delete all the trash from the disk                                |

## Notifications

| FolderNotification        |                                                                                                             |
| ------------------------- | ----------------------------------------------------------------------------------------------------------- |
| DidCreateWorkspace        | Trigger after creating a workspace                                                                          |
| DidDeleteWorkspace        | Trigger after deleting a workspace                                                                          |
| DidUpdateWorkspace        | Trigger after updating a workspace                                                                          |
| DidUpdateWorkspaceApps    | Trigger when the number of apps of the workspace is changed                                                 |
| DidUpdateWorkspaceSetting | Trigger when the settings of the workspace are changed. The changes including the latest visiting view, etc |
| DidUpdateApp              | Trigger when the properties including rename,update description of the app are changed                      |
| DidUpdateView             | Trigger when the properties including rename,update description of the view are changed                     |
| DidDeleteView             | Trigger after deleting the view                                                                             |
| DidRestoreView            | Trigger when restore the view from trash                                                                    |
| DidMoveViewToTrash        | Trigger after moving the view to trash                                                                      |
| DidUpdateTrash            | Trigger when the number of trash is changed                                                                 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appflowy.io/docs/documentation/software-contributions/architecture/frontend/folder/events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.