# Breadcrumbs (cf.cplace.breadcrumbs)

## Overview

The Breadcrumbs app provides a simple navigation widget that displays the hierarchical path from the current page to the workspace home page. This enables users to understand their location within the workspace hierarchy and quickly navigate to parent pages.

**Key Characteristics:**
- Widget-only app (no custom types)
- No dependencies beyond the base platform
- Lightweight navigation enhancement

## Dependencies

| App | Qualified Name | Notes |
|-----|----------------|-------|
| cplace Basis | `cf.cplace.platform` | Always installed (base platform) |

The Breadcrumbs app has no additional dependencies - it only requires the base cplace platform.

## Types Provided

**None** - This app does not provide any custom types. It is purely a UI widget app.

## Widgets Provided

| Widget | Kind | Description | Use Case |
|--------|------|-------------|----------|
| Breadcrumbs | `cf.cplace.breadcrumbs.breadcrumbsWidget` | Shows the hierarchical path to the workspace home page as clickable links | Navigation context and quick parent-page access |

### Widget Details: Breadcrumbs

**Widget Kind:** `cf.cplace.breadcrumbs.breadcrumbsWidget`

**Description:** Displays clickable breadcrumb links showing the page hierarchy from the current page up to the workspace root. Users can click any ancestor page to navigate directly to it.

**Configuration:** The widget has minimal configuration - it automatically detects the page hierarchy based on the page's parent-child relationships.

**Typical Placement:** Top of page layouts, often spanning the full width, to provide persistent navigation context.

## Usage Notes

### When to Use

- **Deep hierarchies**: When workspaces have multiple levels of nested pages and users need orientation
- **Consistent navigation**: When you want users to always see their location in the workspace structure
- **Quick parent access**: When users frequently need to navigate back to parent pages

### When NOT to Use

- **Flat workspaces**: Workspaces with only one or two levels of hierarchy gain little benefit
- **Alternative navigation**: If tile navigation or tree widgets already provide sufficient navigation
- **Minimal layouts**: When screen space is at a premium and the workspace structure is obvious

### Best Practices

1. **Placement**: Add breadcrumbs at the top of type layouts, typically in the first row
2. **Width**: Use full-width (span all columns) for visual prominence
3. **Consistency**: Apply to all types in a workspace for consistent user experience
4. **Combine with title**: Often paired with a Simple Headline widget below it

### Example Layout Pattern

```
Row 1: [Breadcrumbs - full width]
Row 2: [Simple Headline - full width]
Row 3: [Grouped Attributes] [Other widgets...]
```

## Investigation Metadata

- **Investigated on:** 2026-02-02
- **Investigation workspace:** `[App Investigation] cf.cplace.breadcrumbs` (ID: ny3wpq790k80pt8qd4hh6pvwt)
- **Pre-installation baseline:** Only `cf.cplace.platform` with `default.page` and `default.file` types
- **Post-installation changes:** Added Breadcrumbs app with one widget, no new types