> ## Documentation Index
> Fetch the complete documentation index at: https://neo.tvk.company/llms.txt
> Use this file to discover all available pages before exploring further.

# Safe Area

> A smart layout widget that provides appropriate padding based on system safe areas and sidebar state, with smooth animations between states.

## Properties

### Required

<ParamField path="child" type="Widget" required>
  The widget to wrap with safe area padding.
</ParamField>

### Layout

<ParamField path="left" type="bool" default="true">
  Whether to apply safe area padding to the left side.
</ParamField>

<ParamField path="top" type="bool" default="true">
  Whether to apply safe area padding to the top side.
</ParamField>

<ParamField path="right" type="bool" default="true">
  Whether to apply safe area padding to the right side.
</ParamField>

<ParamField path="bottom" type="bool" default="true">
  Whether to apply safe area padding to the bottom side.
</ParamField>

### Behavior

<ParamField path="onlySafeWhenSidebarHidden" type="bool" default="true">
  Whether to use sidebar-aware padding behavior. When true, uses medium spacing when sidebar is visible and system safe area when hidden. When false, always uses system safe area padding.
</ParamField>

## Best Practices

* **Sidebar Integration**: When using with [NeoSidebarLayout](/layouts/sidebar), the default `onlySafeWhenSidebarHidden: true` provides optimal spacing that adapts to sidebar state.
* **Selective Padding**: Use the directional properties (`left`, `top`, `right`, `bottom`) to fine-tune which sides receive safe area treatment based on your layout needs.
* **Root Level Usage**: Place NeoSafeArea at the root of your screen content to ensure proper spacing from system UI elements like status bars and navigation areas.

## Integration Notes

* **Sidebar Detection**: Automatically detects sidebar visibility state and adjusts padding accordingly with smooth animations.
* **System Integration**: Respects system safe areas (notches, dynamic islands, navigation bars) when appropriate.