+
### Wrap Widget
Wrap existing widgets with containers, padding, or other layout widgets to modify their behavior without changing their core functionality.
+To wrap a widget, right click and select "Wrap Widget." Then select a widget to wrap with.
+
+### Jumping to Component Definitions and References
+When building your application, you may want to see where custom components are defined or referenced. For example, you can right click instances of components (denoted using the component icon) and click "See Definition" to jump to the definition of that component in the Widget Tree.
+
+To see references, or usages, of a component, right click on the component and select "See References." This allows you to step through each of the references within the Widget Tree.
+
+
+
+
### Clipboard Operations
-The context menu provides standard clipboard operations (cut, copy, paste) that allow you to move and duplicate widgets across your layout tree. You can use either the context menu options or familiar keyboard shortcuts:
+Right clicking on a widget in the Widget Tree also provides standard clipboard operations (cut, copy, paste) that allow you to move and duplicate widgets across your layout tree. You can use either the context menu options or familiar keyboard shortcuts:
- **Cut**: Ctrl/Cmd + X
- **Copy**: Ctrl/Cmd + C
@@ -163,10 +202,6 @@ The context menu provides standard clipboard operations (cut, copy, paste) that
These operations enable efficient widget reuse and layout restructuring without having to recreate widgets from scratch.
### Go to Code
-The "Go to Code" and "Go to Component" features provide quick navigation from the widget tree to the underlying [code implementation](../content-panel.md#code-editor). You can access these features by hovering over a widget in the tree and right-clicking on the widget to use the context menu options.
-
-- **Go to Code**: Jumps to the Code Editor and highlights the code for the selected widget.
-- **Go to Component**: For custom project widgets, opens the component file with the relevant widget code highlighted.
+The "Go to Code" features provide quick navigation from the Widget Tree to the underlying [code implementation](../content-panel.md#code-editor). You can access these features by hovering over a widget in the tree and right-clicking on the widget and selecting "Go to Code".
-This makes it easy to inspect and modify widget code directly from the visual layout editor.
diff --git a/docs/workspace/properties-panel.md b/docs/workspace/properties-panel.md
index ddc0141..9627b27 100644
--- a/docs/workspace/properties-panel.md
+++ b/docs/workspace/properties-panel.md
@@ -9,7 +9,7 @@ keywords: [properties panel, widget properties, property editing, flutter develo
# Properties Panel
-The Properties Panel is a sophisticated interface for editing widget properties in real-time, providing both visual and code-based editing capabilities with intelligent property type detection and specialized editors.
+The Properties Panel allows you to edit widget properties in real-time, providing both easy-to-use visual editors and flexible code-based editing capabilities.
-
-**Real-Time Property Editing**: The panel displays all properties of the currently selected widget and allows you to edit them with immediate visual feedback. Changes are applied instantly to your running app.
-
-**Intelligent Property Editors:** The system automatically detects property types and provides specialized editors:
-- **Color Properties:** Color picker with hex input and visual color swatches
-- **TextStyle Properties:** Rich text styling editor with font family, size, weight, and color options
-- **Padding/Margin:** Visual padding editor with individual side controls
-- **Border Radius:** Corner-specific radius controls with visual preview
-- **Gradients:** Linear, radial, and sweep gradient editors with color stops
-- **Borders:** Border style, width, and color controls
-- **Images:** Asset and network image selectors
-- **Icons:** Icon picker with search functionality
-- **Alignment:** Visual alignment controls
-- **Boolean Properties:** Toggle switches for true/false values
-- **Enum Properties:** Dropdown menus for predefined options
-
-
-This makes the Properties Panel a comprehensive tool for visual Flutter development, allowing you to modify any aspect of your UI without writing code manually.
-
:::tip[Quick Access from Widget Tree]
-The Properties Panel can be quickly accessed by clicking any widget in the Widget Tree. The panel will automatically update to show the properties of the selected widget.
+The Properties Panel can be quickly accessed by double clicking any widget in the Widget Tree. The panel will automatically update to show the properties of the selected widget.
:::
+:::note[Switching to Code]
+To switch from the visual property editor to a code-based property editor, hover near the property and click the "Switch to Code View" button. You can also cmd+click this button to jump to the specific line in the code editor where the property is defined.
+:::
-### Advanced Functionalities
-
-- **Property Search:** Search functionality to quickly find specific properties within complex widgets.
-- **Add Property Button:** Add new properties to widgets that don't have them configured yet.
-- **Grouped Properties:** For supported widgets (Container, Text, TextField), properties are organized into logical groups like "Layout", "Styling", "Behavior" for easier navigation.
-- **Syntax Highlighting:** For complex expressions and function properties, the panel provides syntax-highlighted code editors.
-- **CopyWith Support:** Automatically handles Flutter's copyWith pattern for updating nested properties like TextStyle sub-properties.
-
+## Ading Hidden Propertis
+Some properties for widgets are hidden by default. However, any property that's accessible in the underlying widget can be set from the property panel.
+If you are looking for a hidden property, you can search for it or add it using the "+ Add Property" button at the top of the Property panel.
## Modifiers
-
-Modifiers refer to wrapper widgets that can be added around existing Flutter widgets to modify their behavior, appearance, or layout. Think of them as "decorators" or "containers" that wrap around your base widgets. They are Flutter widgets that wrap around other widgets to modify their:
+Modifiers refer to wrapper widgets that can be added around existing Flutter widgets to modify their behavior, appearance, or layout. Think of them as "decorators" that wrap around your base widgets. They are Flutter widgets that wrap around other widgets to modify their:
- **Layout behavior** (positioning, sizing, constraints)
- **Visual appearance** (colors, borders, shadows, opacity)
- **Interactive behavior** (gestures, focus, accessibility)
- **Animation properties** (transitions, transformations)
-
+:::note[Modifiers in the Widget Tree]
+Modifier widgets are hidden from the "Simplified View" in the [widget tree](/workspace/widget-tree).
+:::
### Adding a Modifier
diff --git a/docs/workspace/workspace.md b/docs/workspace/workspace.md
index 6f340ad..fc78945 100644
--- a/docs/workspace/workspace.md
+++ b/docs/workspace/workspace.md
@@ -9,25 +9,27 @@ keywords: [workspace, panels, modules panel, content panel, properties panel, ag
# Workspace
-The workspace is organized into several specialized panels that work together to provide a complete development experience. Each panel focuses on specific aspects of your project while maintaining seamless integration with the overall workflow.
+The workspace is organized into panels that work together to provide a complete development experience.
+
+
## Core Panels
- **Top Bar**: Central command center for project navigation, panel management, and deployment. Provides access to project settings, undo/redo functionality, panel visibility controls, and deployment actions.
-- **[Modules Panel](modules-panel/widget-panel.md)**: Helps users access different functional areas of the platform. Includes Widget Tree (default navigation), Theme (styling), Assets (file management), Firebase (backend services), and Supabase (database integration).
+- **[Modules Panel](modules-panel/widget-panel.md)**: Helps users access different functional areas of the platform. Includes Widget Tree (default navigation), Theme (styling), Assets (file management), Firebase (backend services), and Supabase (database integration). The module panel appears on the left side of the screen, and its content is managed through the left-side rail.
-- **[Content Panel](../workspace/content-panel.md)**: Main workspace area that displays either the app preview or code editor depending on the selected mode. Features real-time app preview with device frame options, hot reload/restart controls, and integrated Monaco code editor with syntax highlighting.
+- **[Content Panel](../workspace/content-panel.md)**: Main workspace area that displays either the app preview and/or code editor depending on the selected mode (preview, code or split). Features real-time app preview with device frame options, hot reload/restart controls, and integrated code editor with syntax highlighting and auto-complete. The content panel is in the center of the workspace.
-- **[Properties Panel](../workspace/properties-panel.md)**: Comprehensive property editing interface for selected widgets. Provides intelligent property editors for colors, text styles, padding, borders, gradients, and more, with real-time visual feedback and specialized controls for different Flutter property types.
+- **[Properties Panel](../workspace/properties-panel.md)**: Comprehensive property editing interface for selected widgets. Provides visual property editors for colors, text styles, padding, borders, gradients, and more. When you double click on a widget in the Widget Tree or the Preview, the Property Panel is automatically displayed to the right of the Content Panel.
-- **[Agent Panel](../workspace/agent-panel.md)**: AI-powered development assistant that helps you build and modify your Flutter app through natural language conversations. Features streaming conversations, context management, screenshot integration, and support for multiple AI models.
+- **[Agent Panel](../workspace/agent-panel.md)**: AI-powered development assistant that helps you build and modify your Flutter app through natural language conversations. Features streaming conversations, context management, screenshot integration, and support for multiple AI models. The agent panel is to the right of the workspace.
- **Bottom Bar**: Provides essential project status and debugging tools:
- **Refresh Dependencies**: Runs `flutter pub get` to update project packages
- **Debug Console**: Toggle to view real-time app logs and debugging output
- **App Status**: Live indicator showing if your app is running, loading, has errors, or is stopped
- - **Analysis Issues**: Quick overview of errors, warnings, and info messages in your code
+ - **Analysis Issues**: Quick overview of errors, warnings, and info messages in your code (coming from the code analyzer)
This integrated workspace approach eliminates the need to switch between different tools and provides a cohesive environment for building, testing, and deploying Flutter applications.
\ No newline at end of file