twenty/packages/twenty-docs/getting-started/core-concepts/layout.mdx
Félix Malfait 5d438bb70c
Docs: restructure navigation, add halftone illustrations, clean up hero images (#19728)
## Summary

- **New Getting Started section** with quickstart guide and restructured
navigation
- **Halftone-style illustrations** for User Guide and Developer
introduction cards using a Canvas 2D filter script
- **Removed hero images** (`image:` frontmatter + `<Frame><img>` blocks)
from all user-guide article pages
- **Cleaned up translations** (13 languages): removed hero images and
updated introduction cards to use halftone style
- **Cleaned up twenty-ui pages**: removed outdated hero images from
component docs
- **Deleted orphaned images**: `table.png`, `kanban.png`
- **Developer page**: fixed duplicate icon, switched to 3-column layout

## Test plan

- [ ] Verify docs site builds without errors
- [ ] Check User Guide introduction page renders halftone card images in
both light and dark mode
- [ ] Check Developer introduction page renders 3-column layout with
distinct icons
- [ ] Confirm article pages no longer show hero images at the top
- [ ] Spot-check a few translated pages to ensure hero images are
removed

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: github-actions <github-actions@twenty.com>
2026-04-21 09:13:55 +02:00

68 lines
2.9 KiB
Text

---
title: Layout
description: How to navigate, browse, and view records in Twenty.
icon: "table-columns"
---
## The main layout
The center of the screen is where your records live — people, companies, opportunities, tasks, notes, dashboards, workflows, and any custom objects. You view, edit, and delete records here, and create new views.
<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}}/>
## Navigation bar
The left sidebar gives you:
- **Workspace switcher** — switch between workspaces or create a new one (top dropdown)
- **Search** — press `/` to focus instantly, searches across all objects
- **Settings** — access from the top left
- **Favorites** — pinned views, unique per user
- **Object shortcuts** — quick access to People, Companies, Opportunities, etc.
- **Workflows** — create automations
Drag items to reorder, create folders to group related objects, hide what you don't use.
<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}}/>
## Command menu
Press `Cmd+K` (Mac) or `Ctrl+K` (Windows) — or click the three dots in the top right. From here you can:
- Create new records
- Import and export data via CSV
- Create new views
- Access deleted records (Twenty supports soft and hard deletes)
- See keyboard shortcuts for navigating your workspace
<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}}/>
## Search
Accessible via the Command Menu, the top of the navigation bar, or by pressing `/`. Search works across all objects.
<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}}/>
## Side panel
Click a record to open the side panel on the right — a quick overview of the record's key information without leaving the current page. Click **Open** to go to the full record page.
<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}}/>
## Views
Every object supports multiple views — unlimited per object. Use the dropdown at the top left to switch between them.
- **Table** — spreadsheet-style rows and columns, with grouping, inline editing, and column customization
- **Kanban** — drag-and-drop cards organized by a select field, ideal for pipelines
- **Calendar** — records plotted by a date field for time-based planning
Each view saves its own filters, sorting, and field visibility. Share views with your workspace or keep them private. Favorite views for fast access from the sidebar.
<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}}/>
## Record pages
When you open a record, the detail page is built from configurable **tabs** and **widgets**. Add, remove, reorder, and resize widgets on a grid — fields, related records, emails, timeline, tasks, notes, files, charts, iframes, and more. Each object type has its own layout.
<Card title="Full Layout guide" icon="arrow-right" href="/user-guide/layout/overview">
Navigation, views, record pages — detailed reference and how-tos.
</Card>