Notes, Folders, & Workspace
Relevant source files
The following files were used as context for generating this wiki page:
Conduit provides a native organizational system consisting of Notes, Folders, and a comprehensive Workspace. These components manage user-generated content and server-side resources within a unified mobile interface.
The system synchronizes with Open WebUI when connected, but also maintains on-device state for offline access. Notes and chat drafts remain available without an active network connection.
Sources: README.md:144-145, README.md:214-215
Notes System
The Notes module enables users to capture and manage text and audio information. Notes feature autosave functionality and pinning to ensure important data remains accessible.
Sources: README.md:144-146
Note Capabilities
- AI Enhancement: Users can generate titles or enhance content using AI.
- Multimedia Support: Notes support audio recording and attachments.
- Offline Access: All notes are available for viewing and editing offline.
- Rich Text: The editor utilizes the
parchmentdocument model andfleathereditor components.
Sources: README.md:146, pubspec.yaml:126-128
The diagram shows the flow of data between the user interface, local storage, and AI processing services.
Sources: README.md:144-146, README.md:214-215
Folder Organization
Folders organize conversations and other assets within the Conduit interface. They provide a structural hierarchy for managing long-term chat history and related resources.
Sources: README.md:109-110
Structural Metadata
Folders are managed via unique identifiers and linked to specific chat envelopes.
Sources: packages/conduit_core/test/fixtures/chat_blobs/06_code_executions.json:4-10
| Field | Description |
|---|---|
id | Unique UUID for the object |
folder_id | Identifier linking a resource to a folder (null if root) |
pinned | Boolean flag for high-priority visibility |
archived | Boolean flag for hidden/historical storage |
| Sources: packages/conduit_core/test/fixtures/chat_blobs/06_code_executions.json:4-10 |
Workspace Architecture
The Workspace is a centralized administrative area for managing models, knowledge bases, prompts, tools, and skills. It presents these resources as native mobile screens rather than web views.
Sources: README.md:135-137
Component Areas
| Area | Description |
|---|---|
| Models | Configuration for specific LLM endpoints and parameters |
| Knowledge | Documents and files provided to models for RAG |
| Prompts | Reusable system instructions and templates |
| Tools | Function-calling definitions and integrations |
| Skills | Extended capabilities or specialized behaviors |
| Sources: README.md:135-139 |
Access Control
Conduit implements permission-based visibility for Workspace sections. If a server deployment does not expose a specific capability or the user lacks permission, the corresponding section is hidden from the UI.
Sources: README.md:138-139, README.md:154-155
The class diagram illustrates the hierarchical relationship where the Workspace contains folders, which in turn group individual notes and resources.
Sources: README.md:135-139, packages/conduit_core/test/fixtures/chat_blobs/06_code_executions.json:4-12
Implementation Details
The system relies on several core packages and UI components to maintain consistency across platforms.
Core Dependencies
- conduit_core: Handles business logic and data structures for workspace resources.
- conduit_markdown: Processes rich content within notes and workspace descriptions.
- drift: Provides the persistence layer for on-device folders and notes.
Sources: pubspec.yaml:26-32, pubspec.yaml:124-125
UI Layouts
Workspace and Folder views are governed by specific UI allowlists to ensure proper platform-specific rendering (Material vs. Cupertino).
lib/features/navigation/views/folder_page.dartmanages the folder display logic.lib/features/workspace/views/workspace_page.dartserves as the entry point for workspace management.
Sources: tool/platform_ui_allowlist.yaml:370-380, tool/platform_ui_allowlist.yaml:520-530
Summary: Notes, Folders, and the Workspace provide a native organizational framework in Conduit. This system balances local-first availability with server-side synchronization, allowing users to manage complex AI workflows and personal knowledge bases on mobile devices.