Files
twenty/packages/twenty-apps/examples/postcard/README.md
T
martmullGitHubcubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
d5ff9eb515 Create twenty app improvements (#20688)
create-twenty-app updates:
- remove --example option
- sync --once when scaffolding an applicaiton
- rename --api-url option to --workspace-url
- create a standalone page when scaffolding an app
<img width="1494" height="765" alt="image"
src="https://github.com/user-attachments/assets/0e35ed0c-b0aa-466c-9f56-7939294fd2cf"
/>

---------

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
2026-05-19 13:12:47 +00:00

1.7 KiB

Postcard App — Twenty App Example

A rich example app showcasing all Twenty app entity types. Use this as a reference when building your own apps.

What's included

This app demonstrates every entity type available in the Twenty SDK:

Entity Files What it shows
Application src/application.config.ts App metadata, application variables, server variables
Objects src/objects/ Custom objects with inline fields, junction tables
Fields src/fields/ Standalone fields, relations (ONE_TO_MANY, MANY_TO_ONE), extending standard objects
Logic Functions src/logic-functions/ HTTP routes, database event triggers, cron schedules, tool functions, install hooks
Front Components src/components/ React components rendered inside Twenty's UI
Roles src/roles/ Permission roles with object and field-level access control
Views src/views/ Saved table views with column configuration
Navigation src/navigation-menu-items/ Sidebar links targeting views
Skills src/skills/ AI skill providing context to agents
Agents src/agents/ AI agent with a system prompt
Page Layouts src/page-layouts/ Custom record page with a front component widget

Getting started

# From this directory
yarn install
yarn twenty dev

Learn more