Bump version

.cursor/environment.docker-compose.json

@@ -1,18 +0,0 @@
-{
-  "install": "curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - && sudo apt-get install -y nodejs && node --version && yarn install && echo 'Setting up Docker Compose environment...' && cd packages/twenty-docker && cp -n docker-compose.yml docker-compose.dev.yml || true && echo 'Dependencies installed and docker-compose prepared'",
-  "start": "sudo service docker start && echo 'Docker service started' && cd packages/twenty-docker && echo 'Installing yq for YAML processing...' && sudo apt-get update -qq && sudo apt-get install -y wget && wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 && sudo chmod +x /usr/local/bin/yq && echo 'Patching docker-compose for local development...' && yq eval 'del(.services.server.image)' -i docker-compose.dev.yml && yq eval '.services.server.build.context = \"../../\"' -i docker-compose.dev.yml && yq eval '.services.server.build.dockerfile = \"./packages/twenty-docker/twenty/Dockerfile\"' -i docker-compose.dev.yml && yq eval 'del(.services.worker.image)' -i docker-compose.dev.yml && yq eval '.services.worker.build.context = \"../../\"' -i docker-compose.dev.yml && yq eval '.services.worker.build.dockerfile = \"./packages/twenty-docker/twenty/Dockerfile\"' -i docker-compose.dev.yml && echo 'Setting up .env file with database configuration...' && echo 'SERVER_URL=http://localhost:3000' > .env && echo 'APP_SECRET='$(openssl rand -base64 32) >> .env && echo 'PG_DATABASE_PASSWORD='$(openssl rand -hex 16) >> .env && echo 'PG_DATABASE_URL=postgres://postgres:password@localhost:5432/postgres' >> .env && echo 'SIGN_IN_PREFILLED=true' >> .env && echo 'Building and starting services...' && docker-compose -f docker-compose.dev.yml up -d --build && echo 'Waiting for services to initialize...' && sleep 30 && echo 'Checking service health...' && docker-compose -f docker-compose.dev.yml ps && echo 'Environment setup complete!'",
-  "terminals": [
-    {
-      "name": "Database Setup & Seed",
-      "command": "sleep 40 && cd packages/twenty-docker && echo 'Waiting for PostgreSQL to be ready...' && until docker-compose -f docker-compose.dev.yml exec -T db pg_isready -U postgres; do echo 'Waiting for PostgreSQL...'; sleep 5; done && echo 'PostgreSQL is ready!' && echo 'Waiting for Twenty server to be healthy...' && until docker-compose -f docker-compose.dev.yml exec -T server curl --fail http://localhost:3000/healthz 2>/dev/null; do echo 'Waiting for server...'; sleep 5; done && echo 'Server is healthy!' && echo 'Running database setup and seeding...' && docker-compose -f docker-compose.dev.yml exec -T server npx nx database:reset twenty-server && echo 'Database seeded successfully!' && bash"
-    },
-    {
-      "name": "Application Logs",
-      "command": "sleep 35 && cd packages/twenty-docker && echo 'Following application logs...' && docker-compose -f docker-compose.dev.yml logs -f server worker"
-    },
-    {
-      "name": "Service Monitor",
-      "command": "sleep 15 && cd packages/twenty-docker && echo '=== Service Status Monitor ===' && while true; do clear; echo '=== Service Status at $(date) ===' && docker-compose -f docker-compose.dev.yml ps && echo '\\n=== Health Status ===' && (docker-compose -f docker-compose.dev.yml exec -T server curl -s http://localhost:3000/healthz 2>/dev/null && echo '✅ Twenty Server: Healthy') || echo '❌ Twenty Server: Not Ready' && (docker-compose -f docker-compose.dev.yml exec -T db pg_isready -U postgres 2>/dev/null && echo '✅ PostgreSQL: Ready') || echo '❌ PostgreSQL: Not Ready' && echo '\\n=== Database Connection Test ===' && docker-compose -f docker-compose.dev.yml exec -T server node -e \"const { Client } = require('pg'); const client = new Client({connectionString: process.env.PG_DATABASE_URL}); client.connect().then(() => {console.log('✅ Database Connection: OK'); client.end();}).catch(e => console.log('❌ Database Connection: Failed -', e.message));\" || echo 'Connection test failed' && sleep 45; done"
-    }
-  ]
-} 

.cursor/environment.json

@@ -1,18 +0,0 @@
-{
-  "install": "curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - && sudo apt-get install -y nodejs && node --version && yarn install && echo 'Installing dependencies complete'",
-  "start": "sudo service docker start && echo 'Docker service started' && sleep 3 && echo 'Starting PostgreSQL and Redis containers...' && make postgres-on-docker && make redis-on-docker && echo 'Waiting for containers to initialize...' && sleep 20 && echo 'Checking container status...' && docker ps --filter name=twenty_ && echo 'Waiting for PostgreSQL to be ready...' && until docker exec twenty_pg pg_isready -U postgres -h localhost; do echo 'PostgreSQL not ready yet, waiting...'; sleep 3; done && echo 'PostgreSQL is ready!' && echo 'Setting up database...' && cd packages/twenty-server && npx nx database:reset twenty-server || echo 'Database already initialized' && echo 'Environment setup complete!'",
-  "terminals": [
-    {
-      "name": "Development Server",
-      "command": "echo 'Waiting for database to be fully ready...' && sleep 30 && until docker exec twenty_pg pg_isready -U postgres -h localhost; do echo 'Waiting for PostgreSQL...'; sleep 2; done && echo 'Starting Twenty development server...' && export SERVER_URL=http://localhost:3000 && export PG_DATABASE_URL=postgres://postgres:postgres@localhost:5432/postgres && yarn start"
-    },
-    {
-      "name": "Database Management",
-      "command": "sleep 25 && echo 'Database management terminal ready' && echo 'Waiting for PostgreSQL to be available...' && until docker exec twenty_pg pg_isready -U postgres -h localhost; do echo 'Waiting for PostgreSQL...'; sleep 2; done && echo 'PostgreSQL is ready for database operations!' && echo 'You can now run database commands like:' && echo '  npx nx database:reset twenty-server' && echo '  npx nx database:migrate twenty-server' && bash"
-    },
-    {
-      "name": "Container Logs & Status",
-      "command": "sleep 10 && echo '=== Container Status Monitor ===' && while true; do echo '\\n=== Container Status at $(date) ===' && docker ps --filter name=twenty_ --format 'table {{.Names}}\\t{{.Status}}\\t{{.Ports}}' && echo '\\n=== PostgreSQL Status ===' && (docker exec twenty_pg pg_isready -U postgres -h localhost && echo 'PostgreSQL: ✅ Ready') || echo 'PostgreSQL: ❌ Not Ready' && echo '\\n=== Redis Status ===' && (docker exec twenty_redis redis-cli ping && echo 'Redis: ✅ Ready') || echo 'Redis: ❌ Not Ready' && sleep 30; done"
-    }
-  ]
-} 

.cursor/rules/README.md

@@ -0,0 +1,65 @@
+# Twenty Development Rules
+
+This directory contains Twenty's development guidelines and best practices. The rules are organized into several key categories:
+
+## Guidelines Structure
+
+### 1. Architecture and Structure
+- `architecture.md`: Project overview, technology stack, and infrastructure setup
+- `file-structure-guidelines.md`: File and directory organization patterns
+
+### 2. Code Style and Development
+- `typescript-guidelines.md`: TypeScript best practices and conventions
+- `code-style-guidelines.md`: General coding standards and style guide
+
+### 3. React Development
+- `react-general-guidelines.md`: Core React development principles and patterns
+- `react-state-management-guidelines.md`: State management approaches and best practices
+
+### 4. Testing
+- `testing-guidelines.md`: Testing strategies, patterns, and best practices
+
+### 5. Internationalization
+- `translations.md`: Translation workflow, i18n setup, and string management
+
+## Common Development Commands
+
+### Frontend Commands
+```bash
+# Testing
+npx nx test twenty-front                    # Run unit tests
+npx nx storybook:build twenty-front         # Build Storybook
+npx nx storybook:serve-and-test:static     # Run Storybook tests
+
+# Development
+npx nx lint twenty-front                    # Run linter
+npx nx typecheck twenty-front               # Type checking
+npx nx run twenty-front:graphql:generate    # Generate GraphQL types
+```
+
+### Backend Commands
+```bash
+# Database
+npx nx database:reset twenty-server         # Reset database
+npx nx run twenty-server:database:init:prod # Initialize database
+npx nx run twenty-server:database:migrate:prod # Run migrations
+
+# Development
+npx nx run twenty-server:start             # Start the server
+npx nx run twenty-server:lint              # Run linter (add --fix to auto-fix)
+npx nx run twenty-server:typecheck         # Type checking
+npx nx run twenty-server:test              # Run unit tests
+npx nx run twenty-server:test:integration:with-db-reset # Run integration tests
+
+# Migrations
+npx nx run twenty-server:typeorm migration:generate src/database/typeorm/metadata/migrations/[name] -d src/database/typeorm/metadata/metadata.datasource.ts
+
+# Workspace
+npx nx run twenty-server:command workspace:sync-metadata -f  # Sync metadata
+```
+
+## Usage
+
+These rules are automatically attached to relevant files in your workspace through Cursor's context system. They help maintain consistency and quality across the Twenty codebase.
+
+For the most up-to-date version of these guidelines, always refer to the files in this directory. 

.cursor/rules/README.mdc

@@ -1,144 +0,0 @@
----
-description: Twenty CRM development rules and best practices
-globs: []
-alwaysApply: true
----
-# Twenty Development Rules
-
-This directory contains Twenty's development guidelines and best practices in the modern Cursor Rules format (MDC). These rules are automatically applied based on file patterns and provide context-aware guidance to AI assistants.
-
-## Rules Overview
-
-### Core Guidelines
-- **architecture.mdc** - Project overview, technology stack, and infrastructure setup (Always Applied)
-- **nx-rules.mdc** - Nx workspace guidelines and best practices (Auto-attached to Nx files)
-- **server-migrations.mdc** - Backend migration and TypeORM guidelines for `twenty-server` (Auto-attached to server entities and migration files)
-- **creating-syncable-entity.mdc** - Comprehensive guide for creating new syncable entities (with universalIdentifier and applicationId) in the workspace migration system (Agent-requested for metadata-modules and workspace-migration files)
-
-### Code Quality
-- **typescript-guidelines.mdc** - TypeScript best practices and conventions (Auto-attached to .ts/.tsx files)
-- **code-style.mdc** - General coding standards and style guide (Auto-attached to code files)
-- **file-structure.mdc** - File and directory organization patterns (Auto-attached to config files)
-
-### React Development
-- **react-general-guidelines.mdc** - Core React development principles (Auto-attached to React files)
-- **react-state-management.mdc** - State management approaches with Recoil (Auto-attached to state files)
-
-### Testing & Quality
-- **testing-guidelines.mdc** - Testing strategies and best practices (Auto-attached to test files)
-
-### Internationalization
-- **translations.mdc** - Translation workflow and i18n setup (Auto-attached to locale files)
-
-## How Rules Work
-
-### Automatic Attachment
-Rules are automatically included in your AI context based on file patterns (globs). When you work on TypeScript files, the TypeScript guidelines are automatically loaded.
-
-### Manual Reference
-You can manually reference any rule using the `@ruleName` syntax:
-- `@nx-rules` - Include Nx-specific guidance
-- `@react-general-guidelines` - Load React best practices
-- `@testing-guidelines` - Get testing recommendations
-- `@creating-syncable-entity` - Guide for creating new syncable entities
-
-### Rule Types Used
-- **Always Applied** - Loaded in every context (architecture.mdc, README.mdc)
-- **Auto Attached** - Loaded when matching file patterns are referenced
-- **Agent Requested** - Available for AI to include when relevant
-- **Manual** - Only included when explicitly mentioned
-
-## Development Commands
-
-### Frontend Commands
-```bash
-# Testing
-npx nx test twenty-front                    # Run unit tests
-npx nx storybook:build twenty-front         # Build Storybook
-npx nx storybook:test                       # Run Storybook tests
-
-# Development
-npx nx lint:diff-with-main twenty-front            # Lint files changed vs main (fastest)
-npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix changed files
-npx nx lint twenty-front                    # Lint all files (slower)
-npx nx typecheck twenty-front               # Type checking
-npx nx run twenty-front:graphql:generate    # Generate GraphQL types
-```
-
-### Backend Commands
-```bash
-# Database
-npx nx database:reset twenty-server         # Reset database
-npx nx run twenty-server:database:init:prod # Initialize database
-npx nx run twenty-server:database:migrate:prod # Run migrations
-
-# Development
-npx nx run twenty-server:start             # Start the server
-npx nx lint:diff-with-main twenty-server          # Lint files changed vs main (fastest)
-npx nx lint:diff-with-main twenty-server --configuration=fix  # Auto-fix changed files
-npx nx run twenty-server:lint              # Lint all files (slower)
-npx nx run twenty-server:typecheck         # Type checking
-npx nx run twenty-server:test              # Run unit tests
-npx nx run twenty-server:test:integration:with-db-reset # Run integration tests
-
-# Migrations
-npx nx run twenty-server:typeorm migration:generate src/database/typeorm/core/migrations/[name] -d src/database/typeorm/core/core.datasource.ts
-
-# Workspace
-npx nx run twenty-server:command workspace:sync-metadata -f  # Sync metadata
-```
-
-## Usage Guidelines
-
-### For Developers
-- Rules are automatically applied based on file context
-- Check rule descriptions to understand when they're activated
-- Use manual references (`@ruleName`) for additional context
-- Keep rules updated as the codebase evolves
-
-### For AI Assistants
-- Rules provide consistent guidance across conversations
-- Use rule context to maintain coding standards
-- Reference specific rules when making recommendations
-- Apply rule principles in code suggestions and reviews
-
-## Contributing to Rules
-
-### Adding New Rules
-1. Create a new `.mdc` file in this directory
-2. Include proper metadata headers with description and globs
-3. Write clear, actionable guidelines with examples
-4. Test the rule with relevant file patterns
-5. Update this README if needed
-
-### Updating Existing Rules
-1. Modify the rule content while preserving metadata
-2. Test changes with affected file patterns
-3. Ensure consistency with other rules
-4. Update examples and best practices as needed
-
-## Rule Format Reference
-
-Each rule file uses the MDC format with metadata:
-
-```markdown
----
-description: Brief description of the rule's purpose
-globs: ["**/*.ts", "**/*.tsx"]  # File patterns for auto-attachment
-alwaysApply: false              # Whether to always include this rule
----
-
-# Rule Title
-
-Rule content in Markdown format...
-```
-
-## Migration from Legacy Format
-
-The rules have been migrated from the legacy `.md` format to the modern `.mdc` format, providing:
-- Better context awareness through file pattern matching
-- Improved organization with metadata headers
-- More flexible rule application strategies
-- Enhanced integration with Cursor's AI features
-
-For the most up-to-date version of these guidelines, always refer to the files in this directory.

.cursor/rules/architecture.md

@@ -0,0 +1,97 @@
+# Twenty Project Architecture
+
+## Overview
+Twenty is an open-source CRM built with modern technologies, using TypeScript for both frontend and backend development. This document outlines the core architectural decisions and structure of the project.
+
+## Monorepo Structure
+The project is organized as a monorepo using nx, with the following main packages:
+
+### Main Packages
+- `packages/twenty-front`: Main Frontend application
+  - Technology: React
+  - Purpose: Provides the main user interface for the CRM
+  - Key responsibilities: User interactions, state management, data display
+
+- `packages/twenty-server`: Main Backend application
+  - Technology: NestJS
+  - Purpose: Handles business logic, data persistence, and API
+  - Key responsibilities: Data processing, authentication, API endpoints
+
+- `packages/twenty-website`: Marketing Website and Documentation
+  - Technology: NextJS
+  - Purpose: Public-facing website and documentation
+  - Key responsibilities: Marketing content, documentation, SEO
+
+- `packages/twenty-ui`: UI Component Library
+  - Technology: React
+  - Purpose: Shared UI components and design system
+  - Key responsibilities: Reusable components, design consistency
+
+- `packages/twenty-shared`: Shared Utilities
+  - Purpose: Cross-package shared code between frontend and backend
+  - Contents: Utils, constants, types, interfaces
+
+## Core Technology Stack
+
+### Package Management
+- Package Manager: yarn
+- Monorepo Tool: nx
+- Benefits: Consistent dependency management, shared configurations
+
+### Database Layer
+- Primary Database: PostgreSQL
+- Schema Structure:
+  - Core schema: Main application data
+  - Metadata schema: Configuration and customization data
+  - Workspace schemas: One schema per tenant, containing tenant-specific data
+- ORM Layer:
+  - TypeORM: For core and metadata schemas
+    - Purpose: Type-safe database operations for system data
+    - Benefits: Strong typing, migration support
+  - TwentyORM: For workspace schemas
+    - Purpose: Manages tenant-specific entities and customizations
+    - Benefits: Dynamic entity management, per-tenant customization
+    - Example: Entities like CompanyWorkspaceEntity are managed per workspace
+
+### State Management
+- Frontend State: Recoil
+  - Purpose: Global state management
+  - Use cases: User preferences, UI state, cached data
+
+### Data Layer
+- API Technology: GraphQL
+- Client: Apollo Client
+  - Purpose: Data fetching and caching
+  - Benefits: Type safety, efficient data loading
+
+### Infrastructure
+- Cache: Redis
+  - Purpose: High-performance caching layer
+  - Use cases: Session data, frequent queries
+
+- Authentication: JWT
+  - Purpose: Secure user authentication
+  - Implementation: Token-based auth flow
+
+- Queue System: BullMQ
+  - Purpose: Background job processing
+  - Use cases: Emails, exports, imports
+
+- Storage: S3/Local Filesystem
+  - Purpose: File storage and management
+  - Flexibility: Configurable for cloud or local storage
+
+### Testing Infrastructure
+- Backend Testing:
+  - Framework: Jest
+  - API Testing: Supertest
+  - Coverage: Unit tests, integration tests
+
+- Frontend Testing:
+  - Framework: Jest
+  - Component Testing: Storybook
+  - API Mocking: MSW (Mock Service Worker)
+
+- End-to-End Testing:
+  - Framework: Playwright
+  - Coverage: Critical user journeys 

.cursor/rules/architecture.mdc

@@ -1,30 +0,0 @@
----
-description: Twenty CRM architecture overview - monorepo structure, tech stack, and development principles
-globs: []
-alwaysApply: true
----
-
-# Twenty Architecture
-
-## Tech Stack
-- **Frontend**: React 18, TypeScript, Recoil, Styled Components, Vite
-- **Backend**: NestJS, TypeORM, PostgreSQL, Redis, GraphQL
-- **Monorepo**: Nx workspace with yarn
-
-## Package Structure
-```
-packages/
-├── twenty-front/     # React app
-├── twenty-server/    # NestJS API  
-├── twenty-ui/        # Shared components
-├── twenty-shared/    # Common types/utils
-└── twenty-emails/    # Email templates
-```
-
-## Key Principles
-- **Functional components only** (no classes)
-- **Named exports only** (no default exports)
-- **Types over interfaces** (except for extending third-party)
-- **String literals over enums** (except GraphQL)
-- **No 'any' type allowed**
-- **Event handlers over useEffect** for state updates

.cursor/rules/changelog-process.mdc

@@ -1,324 +0,0 @@
----
-description: Process and guidelines for creating release changelogs for Twenty CRM
-globs: ["**/releases/*.mdx", "**/releases/**"]
-alwaysApply: false
----
-# Twenty Release Changelog Process
-
-Complete guide for creating release changelogs, including codebase research, file structure, and content guidelines.
-
-## Prerequisites
-
-Before starting, gather the following information:
-
-### Required Information
-
-**Version Number**: `{VERSION}` (e.g., 1.9.0, 2.0.0, 2.1.0)
-
-**Release Date**: Use today's date in format: YYYY-MM-DD
-
-### Changes/Features to Document
-
-List the features and changes to include in this release:
-
-1. **Feature Name**: ______________________________
-   - Brief description: ______________________________
-   - Related area (workflow, UI, backend, etc.): ______________________________
-
-2. **Feature Name**: ______________________________
-   - Brief description: ______________________________
-   - Related area: ______________________________
-
-3. **Feature Name**: ______________________________
-   - Brief description: ______________________________
-   - Related area: ______________________________
-
-## Codebase Research Guide
-
-If feature descriptions are not provided or need enhancement, research the codebase:
-
-### Where to Look
-
-**For Workflow Features:**
-- Frontend: `packages/twenty-front/src/modules/workflow/`
-- Backend: `packages/twenty-server/src/modules/workflow/`
-- Components: `packages/twenty-front/src/modules/workflow/components/`
-
-**For UI/UX Changes:**
-- Components: `packages/twenty-front/src/modules/ui/`
-- Layout: `packages/twenty-front/src/modules/layout/`
-- Design system: `packages/twenty-ui/src/`
-
-**For Backend/API Features:**
-- Server modules: `packages/twenty-server/src/modules/`
-- Entities: `packages/twenty-server/src/entities/`
-- Services: Look for `*.service.ts` files
-
-**For Database/ORM Changes:**
-- Migrations: `packages/twenty-server/src/database/typeorm/`
-- Entities: `packages/twenty-server/src/entities/`
-
-### Research Commands
-
-```bash
-# Find recent merged PRs (adjust date as needed)
-gh pr list --search "merged:>2025-10-01" --limit 50 --state merged
-
-# View recent commits
-git log --since="2 weeks ago" --oneline --no-merges
-
-# View commits between releases (replace with actual release tags)
-git log v1.7.0..v1.8.0 --oneline
-
-# Search for specific feature keywords in code
-grep -r "iterator" packages/twenty-front/src/modules/workflow/
-grep -r "bulk select" packages/twenty-front/src/modules/workflow/
-
-# Find recent changes in specific directory
-git log --since="2 weeks ago" --oneline -- packages/twenty-front/src/modules/workflow/
-```
-
-### Using Codebase Search
-
-Use the AI codebase search to find:
-- "How does the workflow iterator node work?"
-- "Where is bulk select implemented for workflows?"
-- "What changes were made to the search node limit?"
-
-## Step-by-Step Process
-
-### 1. Setup Git Branch
-
-**IMPORTANT**: Always start from an up-to-date main branch to avoid merge conflicts and ensure the changelog is based on the latest code.
-
-```bash
-cd /Users/thomascolasdesfrancs/code/twenty
-git checkout main
-git pull origin main
-git checkout -b {VERSION}
-```
-
-Replace `{VERSION}` with the actual version number (e.g., `1.9.0`)
-
-⚠️ **Do this first** before making any file changes. This ensures your branch is based on the latest main.
-
-### 2. Create File Structure
-
-**Create changelog file:**
-- Path: `packages/twenty-website/src/content/releases/{VERSION}.mdx`
-- Example: `packages/twenty-website/src/content/releases/1.9.0.mdx`
-
-**Create image folder:**
-- Path: `packages/twenty-website/public/images/releases/{MINOR_VERSION}/`
-- Example for version 1.9.0: `packages/twenty-website/public/images/releases/1.9/`
-- Example for version 2.0.0: `packages/twenty-website/public/images/releases/2.0/`
-
-```bash
-# Create the image folder
-mkdir -p packages/twenty-website/public/images/releases/{MINOR_VERSION}
-```
-
-### 3. Move Illustration Files
-
-**Source:** `/Users/thomascolasdesfrancs/Downloads/🆕`
-
-**Destination:** `packages/twenty-website/public/images/releases/{MINOR_VERSION}/`
-
-**Naming Convention:** `{VERSION}-descriptive-name.png`
-
-Examples:
-- `1.9.0-feature-name.png`
-- `1.9.0-another-feature.png`
-
-```bash
-# Move and rename files
-cp ~/Downloads/🆕/source-file.png packages/twenty-website/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-name.png
-```
-
-### 4. Research Features (if needed)
-
-If descriptions are not provided:
-1. Use the research commands above to find recent PRs and commits
-2. Search the codebase for feature-related code
-3. Read PR descriptions for context
-4. Check component comments and documentation
-
-### 5. Write Changelog Content
-
-Create the MDX file with this structure:
-
-```markdown
----
-release: {VERSION}
-Date: {YYYY-MM-DD}
----
-
-# Feature 1 Name
-
-Short description explaining what the feature does and why it's useful. Keep it user-focused and concise (1-2 sentences).
-
-![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-1.png)
-
-# Feature 2 Name
-
-Another short description of the second feature.
-
-![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-2.png)
-
-# Feature 3 Name
-
-Description of the third feature.
-
-![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-3.png)
-```
-
-**Style Guidelines:**
-- Use H1 (`#`) for feature names
-- Keep descriptions to 1-2 sentences
-- Focus on user benefits, not technical implementation
-- Use active voice
-- Start with what the user can now do
-- **NEVER mention the brand name "Twenty"** in changelog text - use "your workspace", "the platform", or similar neutral references instead
-
-**Reference Previous Changelogs:**
-- Check `packages/twenty-website/src/content/releases/` for examples
-- Recent releases: 1.7.0.mdx, 1.6.0.mdx, 1.5.0.mdx
-
-### 6. Review
-
-Open the changelog file for review:
-```bash
-# Open in Cursor
-cursor packages/twenty-website/src/content/releases/{VERSION}.mdx
-
-# Open image folder to verify illustrations
-open packages/twenty-website/public/images/releases/{MINOR_VERSION}
-```
-
-Review checklist:
-- [ ] Version number is correct in frontmatter
-- [ ] Date is today's date
-- [ ] All features are documented
-- [ ] Image paths are correct
-- [ ] Image files exist in the folder
-- [ ] Descriptions are clear and user-focused
-- [ ] Spelling and grammar are correct
-
-### 7. Present Changelog for User Approval
-
-**IMPORTANT**: Before committing and creating the PR, always show the complete changelog content to the user and wait for explicit approval.
-
-**What to show:**
-1. Display the full MDX content of the changelog file
-2. Confirm that illustration files were moved to the correct location
-3. List the image file names and paths
-
-**What to say:**
-```
-I've created the changelog for version {VERSION}. Here's the content for your review:
-
-[Show full MDX content]
-
-Images moved to:
-- packages/twenty-website/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-1.png
-- packages/twenty-website/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-2.png
-
-Please review the content. Once you approve, I'll commit the changes and create the pull request.
-```
-
-**Wait for user approval before proceeding to step 8.**
-
-Possible user responses:
-- "Looks good" / "Approve" / "Create the PR" → Proceed to step 8
-- Requests changes → Make the requested edits, then show content again
-- Asks questions → Answer them, then wait for approval
-
-### 8. Commit Changes
-
-```bash
-# Check status
-git status
-
-# Add files
-git add packages/twenty-website/src/content/releases/{VERSION}.mdx
-git add packages/twenty-website/public/images/releases/{MINOR_VERSION}/
-
-# Commit
-git commit -m "Add {VERSION} release changelog"
-
-# Push branch
-git push -u origin {VERSION}
-```
-
-### 9. Create Pull Request
-
-```bash
-# Create PR using GitHub CLI
-gh pr create \
-  --title "Release {VERSION}" \
-  --body "## Release {VERSION}
-
-This release includes:
-
-- Feature 1
-- Feature 2
-- Feature 3
-
-Changelog file: \`packages/twenty-website/src/content/releases/{VERSION}.mdx\`
-Release date: {DATE}" \
-  --base main \
-  --head {VERSION}
-```
-
-Or visit: `https://github.com/twentyhq/twenty/pull/new/{VERSION}`
-
-## File Naming Conventions
-
-### Changelog Files
-- **Format**: `{MAJOR}.{MINOR}.{PATCH}.mdx`
-- **Convention**: One file per complete version
-- **Examples**: `1.6.0.mdx`, `1.7.0.mdx`, `2.0.0.mdx`
-- **Location**: `packages/twenty-website/src/content/releases/`
-
-### Image Folders
-- **Format**: `{MAJOR}.{MINOR}/`
-- **Convention**: One folder per minor version (shared across patches)
-- **Examples**: `1.6/`, `1.7/`, `2.0/`
-- **Location**: `packages/twenty-website/public/images/releases/`
-
-### Image Files
-- **Format**: `{VERSION}-descriptive-name.png`
-- **Convention**: Kebab-case descriptive names
-- **Examples**: 
-  - `1.8.0-workflow-iterator.png`
-  - `1.8.0-bulk-select.png`
-  - `1.9.0-new-feature.png`
-
-## Quick Reference Template
-
-Copy and fill this for each release:
-
-```
-VERSION: ___________
-DATE: ___________
-MINOR_VERSION: ___________
-
-Features to document:
-1. ___________________________
-2. ___________________________
-3. ___________________________
-
-Branch name: {VERSION}
-Changelog path: packages/twenty-website/src/content/releases/{VERSION}.mdx
-Images path: packages/twenty-website/public/images/releases/{MINOR_VERSION}/
-```
-
-## Tips
-
-- **Start early**: Begin documenting features as they're developed
-- **User perspective**: Write for users, not developers
-- **Be concise**: 1-2 sentences per feature
-- **Visual first**: Illustrations should showcase the feature clearly
-- **Consistent style**: Match tone and structure of previous changelogs
-- **Test links**: Verify all image paths work before committing
-- **Research thoroughly**: Use codebase search to understand features deeply

.cursor/rules/code-style-guidelines.md

@@ -0,0 +1,259 @@
+# Code Style Guidelines
+
+## Core Code Style Principles
+Twenty emphasizes clean, readable, and maintainable code. This document outlines our code style conventions and best practices.
+
+## Control Flow
+
+### Early Returns
+- Use early returns to reduce nesting
+- Handle edge cases first
+  ```typescript
+  // ✅ Correct
+  const processUser = (user: User | null) => {
+    if (!user) return null;
+    if (!user.isActive) return null;
+    
+    return {
+      id: user.id,
+      name: user.name,
+    };
+  };
+
+  // ❌ Incorrect
+  const processUser = (user: User | null) => {
+    if (user) {
+      if (user.isActive) {
+        return {
+          id: user.id,
+          name: user.name,
+        };
+      }
+    }
+    return null;
+  };
+  ```
+
+### No Nested Ternaries
+- Avoid nested ternary operators
+- Use if statements or early returns
+  ```typescript
+  // ✅ Correct
+  const getUserDisplay = (user: User) => {
+    if (!user.name) return 'Anonymous';
+    if (!user.isActive) return 'Inactive User';
+    return user.name;
+  };
+
+  // ❌ Incorrect
+  const getUserDisplay = (user: User) => 
+    user.name 
+      ? user.isActive 
+        ? user.name 
+        : 'Inactive User'
+      : 'Anonymous';
+  ```
+
+### No Else-If Chains
+- Use switch statements or lookup objects
+- Keep conditions flat
+  ```typescript
+  // ✅ Correct
+  const getStatusColor = (status: Status): string => {
+    switch (status) {
+      case 'success':
+        return 'green';
+      case 'warning':
+        return 'yellow';
+      case 'error':
+        return 'red';
+      default:
+        return 'gray';
+    }
+  };
+
+  // Or using a lookup object
+  const statusColors: Record<Status, string> = {
+    success: 'green',
+    warning: 'yellow',
+    error: 'red',
+    default: 'gray',
+  };
+
+  // ❌ Incorrect
+  const getStatusColor = (status: Status): string => {
+    if (status === 'success') {
+      return 'green';
+    } else if (status === 'warning') {
+      return 'yellow';
+    } else if (status === 'error') {
+      return 'red';
+    } else {
+      return 'gray';
+    }
+  };
+  ```
+
+## Operators and Expressions
+
+### Optional Chaining Over &&
+- Use optional chaining for null/undefined checks
+- Clearer intent and better type safety
+  ```typescript
+  // ✅ Correct
+  const userName = user?.name;
+  const userAddress = user?.address?.street;
+
+  // ❌ Incorrect
+  const userName = user && user.name;
+  const userAddress = user && user.address && user.address.street;
+  ```
+
+## Function Design
+
+### Small Focused Functions
+- Keep functions small and single-purpose
+- Extract complex logic into helper functions
+  ```typescript
+  // ✅ Correct
+  const validateUser = (user: User) => {
+    if (!isValidName(user.name)) return false;
+    if (!isValidEmail(user.email)) return false;
+    if (!isValidAge(user.age)) return false;
+    return true;
+  };
+
+  const isValidName = (name: string) => {
+    return name.length >= 2 && /^[a-zA-Z\s]*$/.test(name);
+  };
+
+  const isValidEmail = (email: string) => {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+  };
+
+  const isValidAge = (age: number) => {
+    return age >= 18 && age <= 120;
+  };
+
+  // ❌ Incorrect
+  const validateUser = (user: User) => {
+    if (user.name.length < 2 || !/^[a-zA-Z\s]*$/.test(user.name)) return false;
+    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(user.email)) return false;
+    if (user.age < 18 || user.age > 120) return false;
+    return true;
+  };
+  ```
+
+## Naming and Documentation
+
+### Clear Variable Names
+- Use descriptive, intention-revealing names
+- Avoid abbreviations unless common
+  ```typescript
+  // ✅ Correct
+  const isUserActive = user.status === 'active';
+  const hasRequiredPermissions = user.permissions.includes('admin');
+  const userDisplayName = user.name || 'Anonymous';
+
+  // ❌ Incorrect
+  const active = user.status === 'active';
+  const hasPerm = user.permissions.includes('admin');
+  const udn = user.name || 'Anonymous';
+  ```
+
+### No Console.logs in Commits
+- Remove all console.logs before committing
+- Use proper logging/error tracking in production
+  ```typescript
+  // ❌ Incorrect - Don't commit these
+  console.log('user:', user);
+  console.log('debug:', someValue);
+
+  // ✅ Correct - Use proper logging
+  logger.info('User action completed', { userId: user.id });
+  logger.error('Operation failed', { error });
+  ```
+
+### Minimal Comments
+- Write self-documenting code
+- Use comments only for complex business logic
+  ```typescript
+  // ✅ Correct
+  // Calculate pro-rated amount based on billing cycle
+  const calculateProRatedAmount = (amount: number, daysLeft: number, totalDays: number) => {
+    return (amount * daysLeft) / totalDays;
+  };
+
+  // ❌ Incorrect - Unnecessary comments
+  // Get the user's name
+  const getUserName = (user: User) => user.name;
+
+  // Check if user is active
+  const isUserActive = (user: User) => user.status === 'active';
+  ```
+
+## Error Handling
+
+### Proper Error Handling
+- Use try-catch blocks appropriately
+- Provide meaningful error messages
+  ```typescript
+  // ✅ Correct
+  const fetchUserData = async (userId: string) => {
+    try {
+      const response = await api.get(`/users/${userId}`);
+      return response.data;
+    } catch (error) {
+      logger.error('Failed to fetch user data', {
+        userId,
+        error: error instanceof Error ? error.message : 'Unknown error',
+      });
+      throw new UserFetchError('Failed to fetch user data');
+    }
+  };
+
+  // ❌ Incorrect
+  const fetchUserData = async (userId: string) => {
+    try {
+      const response = await api.get(`/users/${userId}`);
+      return response.data;
+    } catch (error) {
+      console.log('error:', error);
+      throw error;
+    }
+  };
+  ```
+
+## Code Organization
+
+### Logical Grouping
+- Group related code together
+- Maintain consistent organization
+  ```typescript
+  // ✅ Correct
+  class UserService {
+    // Properties
+    private readonly api: Api;
+    private readonly logger: Logger;
+
+    // Constructor
+    constructor(api: Api, logger: Logger) {
+      this.api = api;
+      this.logger = logger;
+    }
+
+    // Public methods
+    public async getUser(id: string): Promise<User> {
+      // Implementation
+    }
+
+    public async updateUser(user: User): Promise<User> {
+      // Implementation
+    }
+
+    // Private helpers
+    private validateUser(user: User): boolean {
+      // Implementation
+    }
+  }
+  ``` 

.cursor/rules/code-style.mdc

@@ -1,172 +0,0 @@
----
-description: Code style guidelines for Twenty CRM
-globs: []
-alwaysApply: true
----
-# Code Style Guidelines
-
-## Formatting Standards
-- **Prettier**: 2-space indentation, single quotes, trailing commas, semicolons
-- **Print width**: 80 characters
-- **ESLint**: No unused imports, consistent import ordering, prefer const over let
-
-## Naming Conventions
-```typescript
-// ✅ Variables and functions - camelCase
-const userAccountBalance = 1000;
-const calculateMonthlyPayment = () => {};
-
-// ✅ Constants - SCREAMING_SNAKE_CASE
-const API_ENDPOINTS = {
-  USERS: '/api/users',
-  ORDERS: '/api/orders',
-} as const;
-
-// ✅ Types and Classes - PascalCase
-class UserService {}
-type UserAccountData = {};
-type ButtonProps = {}; // Component props suffix with 'Props'
-
-// ✅ Files and directories - kebab-case
-// user-profile.component.tsx
-// user-profile.styles.ts
-
-// ❌ NEVER use abbreviations in variable names
-// Bad
-const users = data.map((u) => u.name);
-const field = items.find((f) => f.id === id);
-
-// Good
-const users = data.map((user) => user.name);
-const field = items.find((item) => item.id === id);
-const fieldMetadata = inlineFields.find(
-  (fieldMetadataItem) => fieldMetadataItem.name === fieldName,
-);
-```
-
-## Import Organization
-```typescript
-// ✅ Correct import order
-// 1. External libraries
-import React from 'react';
-import { useCallback } from 'react';
-import styled from 'styled-components';
-
-// 2. Internal modules (absolute paths)
-import { Button } from '@/components/ui';
-import { UserService } from '@/services';
-
-// 3. Relative imports
-import { UserCardProps } from './types';
-```
-
-## Function Structure
-```typescript
-// ✅ Small, focused functions
-// ✅ Required parameters first, optional last
-const processUserData = (
-  user: User,
-  options: ProcessingOptions,
-  callback?: (result: ProcessedUser) => void
-): ProcessedUser => {
-  const processedUser = transformUserData(user);
-  applyOptions(processedUser, options);
-
-  if (callback) {
-    callback(processedUser);
-  }
-
-  return processedUser;
-};
-```
-
-## Comments
-```typescript
-// ✅ Use short-form comments, NOT JSDoc blocks
-// ✅ Explain business logic and non-obvious intentions (WHY, not WHAT)
-// Apply 15% discount for premium users with orders > $100
-const discount = isPremiumUser && orderTotal > 100 ? 0.15 : 0;
-
-// TODO: Replace with proper authentication service
-const isAuthenticated = localStorage.getItem('token') !== null;
-
-// ✅ Multi-line comments use multiple // lines (NOT /** */ blocks)
-// Calculates the total price after applying tax and discount
-// Returns the final price that should be charged to the customer
-const calculateTotalPrice = (basePrice: number): number => {
-  // Implementation
-};
-
-// ❌ AVOID obvious comments that just describe what code does
-// Bad: Get all inline fields dynamically
-const { inlineFieldMetadataItems } = useFieldListFieldMetadataItems({...});
-
-// Bad: Define standard fields in display order
-const standardFieldOrder = ['startsAt', 'endsAt', 'conferenceLink'];
-
-// Bad: Split fields into standard and custom
-const standardFields = standardFieldOrder.map(...)
-
-// ✅ GOOD: Only comment if explaining non-obvious business logic
-// Calendar events display standard fields first, then custom fields after participants
-// to maintain consistency with the legacy UI behavior
-const standardFields = standardFieldOrder.map(...)
-
-// ❌ AVOID JSDoc blocks - use short comments instead
-/**
- * This style is NOT preferred in this codebase
- */
-```
-
-**Comment Guidelines:**
-- **DO** comment complex business rules or domain-specific logic
-- **DO** comment non-obvious algorithmic decisions
-- **DO** add TODOs for future improvements
-- **DON'T** comment obvious variable declarations or function calls
-- **DON'T** comment what is already clear from well-named variables/functions
-- **DON'T** add comments that just repeat what the code says
-
-## Utility Helpers
-```typescript
-// ✅ Use existing utility helpers instead of manual checks
-import { isDefined } from 'twenty-shared/utils';
-import { isNonEmptyString, isNonEmptyArray } from '@sniptt/guards';
-
-// ❌ Manual type guards
-const validItems = items.filter((item): item is Item => item !== undefined);
-const hasValue = value !== null && value !== undefined;
-
-// ✅ Use utility helpers
-const validItems = items.filter(isDefined);
-const hasValue = isDefined(value);
-
-// Other useful helpers:
-// - isDefined(value) - checks !== null && !== undefined
-// - isNonEmptyString(value) - checks string is defined and not empty
-// - isNonEmptyArray(value) - checks array is defined and has items
-```
-
-## Security Patterns
-```typescript
-// ✅ CSV Export: Always apply security first, then formatting
-const safeValue = formatValueForCSV(sanitizeValueForCSVExport(userInput));
-
-// ✅ Input validation before processing
-const sanitizedInput = validateAndSanitize(userInput);
-const result = processData(sanitizedInput);
-```
-
-## Error Handling
-```typescript
-// ✅ Proper error types and meaningful messages
-try {
-  const user = await userService.findById(userId);
-  if (!user) {
-    throw new UserNotFoundError(`User with ID ${userId} not found`);
-  }
-  return user;
-} catch (error) {
-  logger.error('Failed to fetch user', { userId, error });
-  throw error;
-}
-```

.cursor/rules/feedback-incorporation.mdc

@@ -1,100 +0,0 @@
----
-description: Guidelines for incorporating user feedback and improving cursor rules
-globs: []
-alwaysApply: true
----
-# Feedback Incorporation Guidelines
-
-## Post-Interaction Reflection
-
-After each coding session or significant interaction, the AI should:
-
-### 1. Reflect on User Feedback
-- **Identify patterns** in user corrections or suggestions
-- **Note recurring issues** that could be prevented with better rules
-- **Recognize gaps** in current cursor rules or guidelines
-
-### 2. Suggest Rule Improvements
-When user provides feedback that reveals a pattern or preference:
-
-```typescript
-// Example feedback patterns to watch for:
-// - "We don't use useEffect, handle state changes in event callbacks"
-// - "We don't use JSDoc blocks, prefer // comments"
-// - "Always use named exports, never default exports"
-// - "We prefer functional components over class components"
-// - "Use event handlers over useEffect for state updates"
-```
-
-### 3. Proactive Rule Suggestions
-At the end of interactions, suggest:
-
-```markdown
-## 💡 Suggested Cursor Rule Updates
-
-Based on your feedback today, I recommend adding/updating these rules:
-
-**Code Style Rule Update:**
-- Add preference for // comments over JSDoc blocks
-- Enforce named exports only (no default exports)
-
-**React Guidelines Update:**
-- Document preference for event handlers over useEffect
-- Add functional components only rule
-
-Would you like me to help incorporate these into your cursor rules?
-```
-
-## Implementation Process
-
-### When to Suggest Updates
-- User corrects the same type of mistake multiple times
-- User explains a codebase-specific preference
-- User points out missing functionality or incomplete implementations
-- User provides context about existing patterns not captured in rules
-
-### How to Present Suggestions
-1. **Summarize the pattern** observed from feedback
-2. **Propose specific rule language** that would prevent the issue
-3. **Explain the benefit** of codifying this knowledge
-4. **Ask for confirmation** before implementing
-
-### Rule Categories to Consider
-- **Code Style**: Formatting, naming, comment styles, export patterns
-- **React Patterns**: Hook usage, component structure, state management
-- **Architecture**: File organization, import patterns, component composition
-- **Testing**: Test structure, naming, coverage expectations
-- **Performance**: Optimization patterns, anti-patterns to avoid
-
-## Example Feedback Integration
-
-```markdown
-## Today's Learning: React State Management Patterns
-
-**User Feedback Received:**
-- "We don't use useEffect, handle state changes in event callbacks"
-- "We don't use JSDoc blocks, prefer // comments"
-- "Always use named exports, never default exports"
-
-**Proposed Rule Additions:**
-```typescript
-// ✅ React State Updates - Use event handlers, not useEffect
-const handleButtonClick = () => {
-  setData(newData); // Direct state update in event handler
-};
-
-// ❌ Avoid useEffect for state updates
-// useEffect(() => { setData(newData); }, [trigger]);
-
-// ✅ Named exports only
-export const UserComponent = () => {};
-export const useUserData = () => {};
-```
-
-**Benefits:**
-- Prevents useEffect overuse and related bugs
-- Ensures consistent export patterns across codebase
-- Documents preferred React patterns for the team
-```
-
-This approach helps the AI learn from each interaction and continuously improve the development experience.

.cursor/rules/file-structure-guidelines.md

@@ -0,0 +1,207 @@
+# File Structure Guidelines
+
+## Core File Structure Principles
+Twenty follows a modular and organized file structure that promotes maintainability and scalability. This document outlines our file organization conventions and best practices.
+
+## Component Organization
+
+### One Component Per File
+- Each component should have its own file
+- File name should match component name
+  ```typescript
+  // ✅ Correct
+  // UserProfile.tsx
+  export const UserProfile = () => {
+    return <div>...</div>;
+  };
+
+  // ❌ Incorrect
+  // users.tsx
+  export const UserProfile = () => {
+    return <div>...</div>;
+  };
+
+  export const UserList = () => {
+    return <div>...</div>;
+  };
+  ```
+
+## Directory Structure
+
+### Feature Modules
+- Place features in `modules/` directory
+- Group related components and logic
+  ```
+  modules/
+  ├── users/
+  │   ├── components/
+  │   │   ├── UserList.tsx
+  │   │   ├── UserCard.tsx
+  │   │   └── UserProfile.tsx
+  │   ├── hooks/
+  │   │   └── useUser.ts
+  │   ├── states/
+  │   │   └── userStates.ts
+  │   └── types/
+  │       └── user.ts
+  ├── workspace/
+  │   ├── components/
+  │   ├── hooks/
+  │   └── states/
+  └── settings/
+      ├── components/
+      ├── hooks/
+      └── states/
+  ```
+
+### Hooks Organization
+- Place hooks in `hooks/` directory
+- Group by feature or global usage
+  ```
+  hooks/
+  ├── useClickOutside.ts
+  ├── useDebounce.ts
+  └── features/
+      ├── users/
+      │   ├── useUserActions.ts
+      │   └── useUserData.ts
+      └── workspace/
+          └── useWorkspaceSettings.ts
+  ```
+
+### State Management
+- Place state definitions in `states/` directory
+- Organize by feature
+  ```
+  states/
+  ├── global/
+  │   ├── theme.ts
+  │   └── navigation.ts
+  ├── users/
+  │   ├── atoms.ts
+  │   └── selectors.ts
+  └── workspace/
+      ├── atoms.ts
+      └── selectors.ts
+  ```
+
+### Types Organization
+- Place types in `types/` directory
+- Group by domain or feature
+  ```
+  types/
+  ├── common.ts
+  ├── api.ts
+  └── features/
+      ├── user.ts
+      ├── workspace.ts
+      └── settings.ts
+  ```
+
+## Naming Conventions
+
+### Component Files
+- Use PascalCase for component files
+- Use descriptive, feature-specific names
+  ```
+  components/
+  ├── UserProfile.tsx
+  ├── UserProfileHeader.tsx
+  └── UserProfileContent.tsx
+  ```
+
+### Non-Component Files
+- Use camelCase for non-component files
+- Use clear, descriptive names
+  ```
+  hooks/
+  ├── useClickOutside.ts
+  └── useDebounce.ts
+
+  utils/
+  ├── dateFormatter.ts
+  └── stringUtils.ts
+  ```
+
+## Module Structure
+
+### Feature Module Organization
+- Consistent structure across features
+- Clear separation of concerns
+  ```
+  modules/users/
+  ├── components/
+  │   ├── UserList/
+  │   │   ├── UserList.tsx
+  │   │   ├── UserListItem.tsx
+  │   │   └── UserListHeader.tsx
+  │   └── UserProfile/
+  │       ├── UserProfile.tsx
+  │       └── UserProfileHeader.tsx
+  ├── hooks/
+  │   ├── useUserList.ts
+  │   └── useUserProfile.ts
+  ├── states/
+  │   ├── atoms.ts
+  │   └── selectors.ts
+  ├── types/
+  │   └── user.ts
+  └── utils/
+      └── userFormatter.ts
+  ```
+
+## Best Practices
+
+### Import Organization
+- Group imports by type
+- Maintain consistent order
+  ```typescript
+  // External dependencies
+  import { useState } from 'react';
+  import { styled } from '@emotion/styled';
+
+  // Internal modules
+  import { useUser } from '~/modules/users/hooks';
+  import { userState } from '~/modules/users/states';
+
+  // Local imports
+  import { UserAvatar } from './UserAvatar';
+  import { type UserProfileProps } from './types';
+  ```
+
+### Path Aliases
+- Use path aliases for better imports
+- Avoid deep relative paths
+  ```typescript
+  // ✅ Correct
+  import { Button } from '~/components/Button';
+  import { useUser } from '~/modules/users/hooks';
+
+  // ❌ Incorrect
+  import { Button } from '../../../components/Button';
+  import { useUser } from '../../../modules/users/hooks';
+  ```
+
+### Component Co-location
+- Keep related files close together
+- Use index files for public APIs
+  ```
+  components/UserProfile/
+  ├── UserProfile.tsx
+  ├── UserProfileHeader.tsx
+  ├── UserProfileContent.tsx
+  ├── styles.ts
+  ├── types.ts
+  └── index.ts
+  ```
+
+### Test File Location
+- Place test files next to implementation
+- Use `.test.ts` or `.spec.ts` extension
+  ```
+  components/
+  ├── UserProfile.tsx
+  ├── UserProfile.test.tsx
+  ├── UserProfile.stories.tsx
+  └── types.ts
+  ``` 

.cursor/rules/file-structure.mdc

@@ -1,107 +0,0 @@
----
-description: File structure guidelines for Twenty CRM
-globs: []
-alwaysApply: true
----
-# File Structure Guidelines
-
-## Directory Organization
-```
-packages/twenty-front/src/
-├── components/      # Reusable UI components
-├── pages/          # Route components  
-├── modules/        # Feature modules
-├── hooks/          # Custom hooks
-├── services/       # API services
-└── types/          # Type definitions
-
-packages/twenty-server/src/
-├── modules/        # Feature modules
-├── entities/       # Database entities
-├── dto/           # Data transfer objects
-└── utils/         # Helper functions
-```
-
-## File Naming
-- **kebab-case** for all files and directories
-- **Descriptive suffixes** for clarity
-```
-// ✅ Correct naming
-user-profile.component.tsx
-user-profile.styles.ts
-user-profile.test.tsx
-user.service.ts
-user.entity.ts
-create-user.dto.ts
-```
-
-## Index Files & Barrel Exports
-```typescript
-// ✅ Clean barrel exports in index.ts
-export { UserCard } from './user-card.component';
-export { UserList } from './user-list.component';
-export type { UserCardProps, UserListProps } from './types';
-
-// ✅ Usage - clean imports
-import { UserCard, UserList } from '@/components/user';
-```
-
-## Module Structure
-```
-src/modules/user/
-├── components/     # Module-specific components
-├── hooks/         # Module hooks
-├── services/      # API services
-├── types/         # Type definitions
-└── index.ts       # Module exports
-```
-
-## Import/Export Patterns
-```typescript
-// ✅ Import organization
-// 1. External libraries
-import React from 'react';
-import styled from 'styled-components';
-
-// 2. Internal modules (absolute paths)
-import { Button } from '@/components/ui';
-import { UserService } from '@/services';
-
-// 3. Relative imports
-import { UserCardProps } from './types';
-
-// ✅ Named exports only (no default exports)
-export const UserComponent = ({ user }: UserProps) => {
-  // Component implementation
-};
-```
-
-## File Size Guidelines
-- **Components**: Under 300 lines
-- **Services**: Under 500 lines  
-- **Extract logic** into hooks/utilities when files grow large
-- **Use composition** over large monolithic components
-
-## Configuration Files
-
-### Project Configuration
-```
-.vscode/                       # VSCode settings
-├── settings.json
-├── extensions.json
-└── launch.json
-
-.github/                       # GitHub workflows
-├── workflows/
-└── templates/
-
-.cursor/                       # Cursor rules
-├── rules/
-└── environment.json
-```
-
-### Build Configuration
-- Keep build configs in root or package directories
-- Use consistent naming for config files
-- Comment complex configurations
-- Version control all configuration files

.cursor/rules/nx-rules.mdc

@@ -1,89 +0,0 @@
----
-description: Guidelines and best practices for working with Nx in the Twenty workspace, including workspace architecture understanding, configuration management, and generator usage.
-globs: ["**/nx.json", "**/project.json", "**/workspace.json"]
-alwaysApply: true
----
-
-# Nx Guidelines
-
-## Core Commands
-```bash
-# Run target for specific project
-npx nx run twenty-front:build
-npx nx run twenty-server:test
-
-# Lint diff with main (recommended - much faster!)
-npx nx lint:diff-with-main twenty-front           # Lint only files changed vs main
-npx nx lint:diff-with-main twenty-server
-npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix changed files
-
-# Run target for all projects (slower)
-npx nx run-many --target=build --all
-npx nx run-many --target=test --projects=twenty-front,twenty-server
-
-# Generate/modify projects
-npx nx g @nx/react:app my-app
-npx nx g @nx/react:component my-component
-```
-
-## Project Structure
-- Each package has a `project.json` with targets
-- Dependencies managed through `tsconfig.json` path mappings
-- Shared libraries in `packages/` directory
-
-## Build Targets
-```json
-// project.json
-{
-  "targets": {
-    "build": {
-      "executor": "@nx/vite:build",
-      "options": { "outputPath": "dist/packages/twenty-front" }
-    },
-    "test": {
-      "executor": "@nx/jest:jest",
-      "options": { "jestConfig": "packages/twenty-front/jest.config.mjs" }
-    }
-  }
-}
-```
-
-## Linting Strategy
-For faster development, always prefer linting only changed files:
-- Use `npx nx lint:diff-with-main <project>` to lint only files changed vs main branch
-- Use `--configuration=fix` to auto-fix issues in changed files
-- Only use `npx nx lint <project>` when you need to lint the entire project
-
-## Dependency Graph
-```bash
-# View project dependencies
-npx nx graph
-
-# Check what's affected by changes (runs target on affected projects)
-npx nx affected --target=test
-npx nx affected --target=build --base=main
-```
-
-## Library Management
-- Use `npx nx g @nx/workspace:library` generator for shared libs
-- Internal imports use `@/` path mapping
-- Libraries must export through index.ts barrel files
-
-## Cache Configuration
-- Nx caches build outputs and test results
-- Configure `outputs` in project.json targets
-- Use `inputs` to define what invalidates cache
-
-```json
-{
-  "build": {
-    "outputs": ["dist/packages/my-app"],
-    "inputs": ["source", "^source"],
-    "cache": true
-  }
-}
-```
-
-
-
-

.cursor/rules/react-general-guidelines.md

@@ -0,0 +1,220 @@
+# React Guidelines
+
+## Core React Principles
+Twenty follows modern React best practices with a focus on functional components and clean, maintainable code. This document outlines our React conventions and best practices.
+
+## Component Structure
+
+### Functional Components Only
+- Use functional components exclusively
+- No class components allowed
+  ```typescript
+  // ✅ Correct
+  export const UserProfile = ({ user }: UserProfileProps) => {
+    return (
+      <StyledContainer>
+        <h1>{user.name}</h1>
+      </StyledContainer>
+    );
+  };
+
+  // ❌ Incorrect
+  export class UserProfile extends React.Component<UserProfileProps> {
+    render() {
+      return (
+        <StyledContainer>
+          <h1>{this.props.user.name}</h1>
+        </StyledContainer>
+      );
+    }
+  }
+  ```
+
+### Named Exports
+- Use named exports exclusively
+- No default exports
+  ```typescript
+  // ✅ Correct
+  export const Button = ({ label }: ButtonProps) => {
+    return <button>{label}</button>;
+  };
+
+  // ❌ Incorrect
+  export default function Button({ label }: ButtonProps) {
+    return <button>{label}</button>;
+  }
+  ```
+
+## State and Effects
+
+### Event Handlers Over useEffect
+- Prefer event handlers for state updates
+- Avoid useEffect for state synchronization
+  ```typescript
+  // ✅ Correct
+  const UserForm = () => {
+    const handleSubmit = async (data: FormData) => {
+      await updateUser(data);
+      refreshUserList();
+    };
+
+    return <Form onSubmit={handleSubmit} />;
+  };
+
+  // ❌ Incorrect
+  const UserForm = () => {
+    useEffect(() => {
+      if (formData) {
+        updateUser(formData);
+      }
+    }, [formData]);
+
+    return <Form />;
+  };
+  ```
+
+## Component Design
+
+### Small, Focused Components
+- Keep components small and single-purpose
+- Extract reusable logic into custom hooks
+  ```typescript
+  // ✅ Correct
+  const UserCard = ({ user }: UserCardProps) => {
+    return (
+      <StyledCard>
+        <UserAvatar user={user} />
+        <UserInfo user={user} />
+        <UserActions user={user} />
+      </StyledCard>
+    );
+  };
+
+  // ❌ Incorrect
+  const UserCard = ({ user }: UserCardProps) => {
+    return (
+      <StyledCard>
+        {/* Too much logic in one component */}
+        <img src={user.avatar} />
+        <div>{user.name}</div>
+        <div>{user.email}</div>
+        <button onClick={() => handleEdit(user)}>Edit</button>
+        <button onClick={() => handleDelete(user)}>Delete</button>
+        {/* More complex logic... */}
+      </StyledCard>
+    );
+  };
+  ```
+
+## Props
+
+### Prop Naming
+- Use clear, descriptive prop names
+- Follow React conventions (onClick, isActive, etc.)
+  ```typescript
+  // ✅ Correct
+  type ButtonProps = {
+    onClick: () => void;
+    isDisabled?: boolean;
+    isLoading?: boolean;
+  };
+
+  // ❌ Incorrect
+  type ButtonProps = {
+    clickHandler: () => void;
+    disabled?: boolean;
+    loading?: boolean;
+  };
+  ```
+
+### Prop Destructuring
+- Destructure props with proper typing
+- Use TypeScript for prop types
+  ```typescript
+  // ✅ Correct
+  const Button = ({ onClick, isDisabled, children }: ButtonProps) => {
+    return (
+      <button onClick={onClick} disabled={isDisabled}>
+        {children}
+      </button>
+    );
+  };
+
+  // ❌ Incorrect
+  const Button = (props: ButtonProps) => {
+    return (
+      <button onClick={props.onClick} disabled={props.isDisabled}>
+        {props.children}
+      </button>
+    );
+  };
+  ```
+
+## Performance Optimization
+
+### Memoization
+- Use memo for expensive computations
+- Avoid premature optimization
+  ```typescript
+  // ✅ Correct - Complex computation
+  const MemoizedChart = memo(({ data }: ChartProps) => {
+    // Complex rendering logic
+    return <ComplexChart data={data} />;
+  });
+
+  // ❌ Incorrect - Unnecessary memoization
+  const MemoizedText = memo(({ text }: { text: string }) => {
+    return <span>{text}</span>;
+  });
+  ```
+
+### Event Handlers
+- Use callback refs for DOM manipulation
+- Memoize callbacks when needed
+  ```typescript
+  // ✅ Correct
+  const UserList = () => {
+    const handleScroll = useCallback((event: UIEvent) => {
+      // Complex scroll handling
+    }, []);
+
+    return <div onScroll={handleScroll}>{/* content */}</div>;
+  };
+  ```
+
+## Error Handling
+
+### Error Boundaries
+- Use error boundaries for component error handling
+- Provide meaningful fallback UIs
+  ```typescript
+  // ✅ Correct
+  const ErrorFallback = ({ error }: { error: Error }) => (
+    <StyledError>
+      <h2>Something went wrong</h2>
+      <pre>{error.message}</pre>
+    </StyledError>
+  );
+
+  const SafeComponent = () => (
+    <ErrorBoundary FallbackComponent={ErrorFallback}>
+      <ComponentThatMightError />
+    </ErrorBoundary>
+  );
+  ```
+
+### Loading States
+- Handle loading states gracefully
+- Provide meaningful loading indicators
+  ```typescript
+  // ✅ Correct
+  const UserProfile = () => {
+    const { data: user, isLoading, error } = useUser();
+
+    if (isLoading) return <LoadingSpinner />;
+    if (error) return <ErrorMessage error={error} />;
+    if (!user) return <NotFound />;
+
+    return <UserProfileContent user={user} />;
+  };
+  ``` 

.cursor/rules/react-general-guidelines.mdc

@@ -1,85 +0,0 @@
----
-description: React general guidelines for Twenty CRM
-alwaysApply: false
----
-# React Guidelines
-
-## Core Rules
-- **Functional components only** (no classes)
-- **Named exports only** (no default exports)
-- **Event handlers over useEffect** for state updates
-
-## Component Structure
-```typescript
-// ✅ Correct
-export const UserProfile = ({ user, onEdit }: UserProfileProps) => {
-  const handleEdit = () => onEdit(user.id);
-  
-  return (
-    <StyledContainer>
-      <h1>{user.name}</h1>
-      <Button onClick={handleEdit}>Edit</Button>
-    </StyledContainer>
-  );
-};
-```
-
-## Props & Event Handlers
-```typescript
-// ✅ Correct - Destructure props
-const Button = ({ onClick, isDisabled, children }: ButtonProps) => (
-  <button onClick={onClick} disabled={isDisabled}>
-    {children}
-  </button>
-);
-
-// ✅ Correct - Event handlers over useEffect
-const UserForm = ({ onSubmit }: UserFormProps) => {
-  const handleSubmit = async (data: FormData) => {
-    await onSubmit(data);
-    // Direct event handling, not useEffect
-  };
-
-  return <Form onSubmit={handleSubmit} />;
-};
-```
-
-## Component Design
-- **Small, focused components** - Single responsibility
-- **Composition over inheritance** - Combine simple components
-- **Extract complex logic** into custom hooks
-
-```typescript
-// ✅ Good - Composed from smaller components
-const UserCard = ({ user }: UserCardProps) => (
-  <StyledCard>
-    <UserAvatar user={user} />
-    <UserInfo user={user} />
-    <UserActions user={user} />
-  </StyledCard>
-);
-```
-
-## Performance
-```typescript
-// ✅ Use memo for expensive components only
-const ExpensiveChart = memo(({ data }: ChartProps) => {
-  // Complex rendering logic
-  return <ComplexChart data={data} />;
-});
-
-// ✅ Memoize callbacks when needed
-const UserList = ({ users, onUserSelect }: UserListProps) => {
-  const handleUserSelect = useCallback((user: User) => {
-    onUserSelect(user);
-  }, [onUserSelect]);
-
-  return (
-    <div>
-      {users.map(user => (
-        <UserItem key={user.id} user={user} onSelect={handleUserSelect} />
-      ))}
-    </div>
-  );
-};
-```

.cursor/rules/react-state-management-guidelines.md

@@ -0,0 +1,219 @@
+# State Management Guidelines
+
+## Core State Management Principles
+Twenty uses a combination of Recoil for global state and Apollo Client for server state management. This document outlines our state management conventions and best practices.
+
+## Global State Management
+
+### Recoil Usage
+- Use Recoil for global application state
+- Keep atoms small and focused
+  ```typescript
+  // ✅ Correct
+  // states/theme.ts
+  export const themeState = atom<'light' | 'dark'>({
+    key: 'themeState',
+    default: 'light',
+  });
+
+  // states/user.ts
+  export const userState = atom<User | null>({
+    key: 'userState',
+    default: null,
+  });
+
+  // ❌ Incorrect
+  // states/globalState.ts
+  export const globalState = atom({
+    key: 'globalState',
+    default: {
+      theme: 'light',
+      user: null,
+      settings: {},
+      // ... many other unrelated pieces of state
+    },
+  });
+  ```
+
+### Atom Organization
+- Place atoms in the `states/` directory
+- Group related atoms in feature-specific files
+  ```typescript
+  // states/workspace/atoms.ts
+  export const workspaceIdState = atom<string>({
+    key: 'workspaceIdState',
+    default: '',
+  });
+
+  export const workspaceSettingsState = atom<WorkspaceSettings>({
+    key: 'workspaceSettingsState',
+    default: defaultSettings,
+  });
+  ```
+
+## Server State Management
+
+### Apollo Client Usage
+- Use Apollo Client for all GraphQL operations
+- Leverage Apollo's caching capabilities
+  ```typescript
+  // ✅ Correct
+  const { data, loading } = useQuery(GET_USER_QUERY, {
+    variables: { id },
+    fetchPolicy: 'cache-first',
+  });
+
+  // ❌ Incorrect
+  const [user, setUser] = useState(null);
+  useEffect(() => {
+    fetch('/api/user/' + id).then(setUser);
+  }, [id]);
+  ```
+
+### Query Organization
+- Separate operation files
+- Use fragments for shared fields
+  ```typescript
+  // queries/user.ts
+  export const UserFragment = gql`
+    fragment UserFields on User {
+      id
+      name
+      email
+    }
+  `;
+
+  export const GET_USER = gql`
+    query GetUser($id: ID!) {
+      user(id: $id) {
+        ...UserFields
+      }
+    }
+    ${UserFragment}
+  `;
+  ```
+
+## State Management Best Practices
+
+### Multiple Small Atoms
+- Prefer multiple small atoms over prop drilling
+- Keep atoms focused on specific features
+  ```typescript
+  // ✅ Correct
+  export const selectedViewState = atom<string>({
+    key: 'selectedViewState',
+    default: '',
+  });
+
+  export const viewFiltersState = atom<ViewFilters>({
+    key: 'viewFiltersState',
+    default: {},
+  });
+
+  // ❌ Incorrect - Prop drilling
+  const ViewContainer = ({ selectedView, filters, onViewChange }) => {
+    return (
+      <ViewHeader view={selectedView} onViewChange={onViewChange}>
+        <ViewContent>
+          <ViewFilters filters={filters} />
+        </ViewContent>
+      </ViewHeader>
+    );
+  };
+  ```
+
+### No useRef for State
+- Never use useRef for state management
+- Use proper state management tools
+  ```typescript
+  // ✅ Correct
+  const [count, setCount] = useState(0);
+  // or
+  const [count, setCount] = useRecoilState(countState);
+
+  // ❌ Incorrect
+  const countRef = useRef(0);
+  ```
+
+### Data Fetching
+- Extract data fetching to sibling components
+- Keep components focused on presentation
+  ```typescript
+  // ✅ Correct
+  const UserProfileContainer = () => {
+    const { data, loading } = useQuery(GET_USER);
+    if (loading) return <LoadingSpinner />;
+    return <UserProfile user={data.user} />;
+  };
+
+  const UserProfile = ({ user }: UserProfileProps) => {
+    return <div>{user.name}</div>;
+  };
+
+  // ❌ Incorrect
+  const UserProfile = () => {
+    const { data, loading } = useQuery(GET_USER);
+    if (loading) return <LoadingSpinner />;
+    return <div>{data.user.name}</div>;
+  };
+  ```
+
+### Hook Usage
+- Use appropriate hooks for state access
+- Choose between useRecoilValue and useRecoilState based on needs
+  ```typescript
+  // ✅ Correct - Read-only access
+  const theme = useRecoilValue(themeState);
+
+  // ✅ Correct - Read-write access
+  const [theme, setTheme] = useRecoilState(themeState);
+
+  // ❌ Incorrect - Using state setter when only reading
+  const [theme, _] = useRecoilState(themeState);
+  ```
+
+## Performance Considerations
+
+### Selector Usage
+- Use selectors for derived state
+- Memoize complex calculations
+  ```typescript
+  // ✅ Correct
+  const filteredUsersState = selector({
+    key: 'filteredUsersState',
+    get: ({ get }) => {
+      const users = get(usersState);
+      const filter = get(userFilterState);
+      return users.filter(user => 
+        user.name.toLowerCase().includes(filter.toLowerCase())
+      );
+    },
+  });
+
+  // ❌ Incorrect - Calculating in component
+  const UserList = () => {
+    const users = useRecoilValue(usersState);
+    const filter = useRecoilValue(userFilterState);
+    const filteredUsers = users.filter(user =>
+      user.name.toLowerCase().includes(filter.toLowerCase())
+    );
+    return <List users={filteredUsers} />;
+  };
+  ```
+
+### Cache Management
+- Configure appropriate cache policies
+- Handle cache invalidation properly
+  ```typescript
+  // ✅ Correct
+  const [updateUser] = useMutation(UPDATE_USER, {
+    update: (cache, { data }) => {
+      cache.modify({
+        id: cache.identify(data.updateUser),
+        fields: {
+          name: () => data.updateUser.name,
+        },
+      });
+    },
+  });
+  ``` 

.cursor/rules/react-state-management.mdc

@@ -1,80 +0,0 @@
----
-description: React state management guidelines for Twenty CRM
-alwaysApply: false
----
-# React State Management
-
-## Recoil Patterns
-```typescript
-// ✅ Atoms for primitive state
-export const currentUserState = atom<User | null>({
-  key: 'currentUserState',
-  default: null,
-});
-
-// ✅ Selectors for derived state
-export const userDisplayNameSelector = selector({
-  key: 'userDisplayNameSelector',
-  get: ({ get }) => {
-    const user = get(currentUserState);
-    return user ? `${user.firstName} ${user.lastName}` : 'Guest';
-  },
-});
-
-// ✅ Atom families for dynamic atoms
-export const userByIdState = atomFamily<User | null, string>({
-  key: 'userByIdState',
-  default: null,
-});
-```
-
-## Local State Guidelines
-```typescript
-// ✅ Multiple useState for unrelated state
-const [isLoading, setIsLoading] = useState(false);
-const [error, setError] = useState<string | null>(null);
-const [data, setData] = useState<User[]>([]);
-
-// ✅ useReducer for complex state logic
-type FormAction = 
-  | { type: 'SET_FIELD'; field: string; value: string }
-  | { type: 'SET_ERRORS'; errors: Record<string, string> }
-  | { type: 'RESET' };
-
-const formReducer = (state: FormState, action: FormAction): FormState => {
-  switch (action.type) {
-    case 'SET_FIELD':
-      return { ...state, [action.field]: action.value };
-    case 'SET_ERRORS':
-      return { ...state, errors: action.errors };
-    case 'RESET':
-      return initialFormState;
-    default:
-      return state;
-  }
-};
-```
-
-## Data Flow Rules
-- **Props down, events up** - Unidirectional data flow
-- **Avoid bidirectional binding** - Use callback functions
-- **Normalize complex data** - Use lookup tables over nested objects
-
-```typescript
-// ✅ Normalized state structure
-type UsersState = {
-  byId: Record<string, User>;
-  allIds: string[];
-};
-
-// ✅ Functional state updates
-const increment = useCallback(() => {
-  setCount(prev => prev + 1);
-}, []);
-```
-
-## Performance Tips
-- Use atom families for dynamic data collections
-- Implement proper selector caching
-- Avoid heavy computations in selectors
-- Batch state updates when possible

.cursor/rules/server-migrations.mdc

@@ -1,29 +0,0 @@
----
-description: Guidelines for generating and managing TypeORM migrations in twenty-server
-globs: [
-  "packages/twenty-server/src/**/*.entity.ts",
-  "packages/twenty-server/src/database/typeorm/**/*.ts"
-]
-alwaysApply: false
----
-
-## Server Migrations (twenty-server)
-
-- **When changing an entity, always generate a migration**
-  - If you modify a `*.entity.ts` file in `packages/twenty-server/src`, you **must** generate a corresponding TypeORM migration instead of manually editing the database schema.
-  - Use the Nx + TypeORM command from the project root:
-
-    ```bash
-    npx nx run twenty-server:typeorm migration:generate src/database/typeorm/core/migrations/common/[name] -d src/database/typeorm/core/core.datasource.ts
-    ```
-
-  - Replace `[name]` with a descriptive, kebab-case migration name that reflects the change (for example, `add-agent-turn-evaluation`).
-
-- **Prefer generated migrations over manual edits**
-  - Let TypeORM infer schema changes from the updated entities; only adjust the generated migration file manually if absolutely necessary (for example, for data backfills or complex constraints).
-  - Keep schema changes (DDL) in these generated migrations and avoid mixing in heavy data migrations unless there is a strong reason and clear comments.
-
-- **Keep migrations consistent and reversible**
-  - Ensure the generated migration includes both `up` and `down` logic that correctly applies and reverts the entity change when possible.
-  - Do not delete or rewrite existing, committed migrations unless you are explicitly working on a pre-release branch where history rewrites are allowed by team conventions.
-

.cursor/rules/testing-guidelines.md

@@ -0,0 +1,253 @@
+# Testing Guidelines
+
+## Core Testing Principles
+Twenty follows a comprehensive testing strategy across all packages, ensuring high-quality, maintainable code. This document outlines our testing conventions and best practices.
+
+## Testing Stack
+
+### Backend Testing
+- Primary Framework: Jest
+- API Testing: Supertest
+- Coverage Requirements: 80% minimum
+
+### Frontend Testing
+- Component Testing: Jest + React Testing Library
+- Visual Testing: Storybook
+- API Mocking: MSW (Mock Service Worker)
+
+### End-to-End Testing
+- Framework: Playwright
+- Coverage: Critical user journeys
+- Cross-browser testing
+
+## Test Organization
+
+### Test File Location
+- Co-locate tests with implementation files
+- Use consistent naming patterns
+  ```
+  src/
+  ├── components/
+  │   ├── UserProfile.tsx
+  │   ├── UserProfile.test.tsx
+  │   └── UserProfile.stories.tsx
+  ```
+
+### Test File Naming
+- Use `.test.ts(x)` for unit/integration tests
+- Use `.spec.ts(x)` for E2E tests
+- Use `.stories.tsx` for Storybook stories
+
+## Unit Testing
+
+### Component Testing
+- Test behavior, not implementation
+- Use React Testing Library best practices
+  ```typescript
+  // ✅ Correct
+  test('displays user name when provided', () => {
+    render(<UserProfile user={{ name: 'John Doe' }} />);
+    expect(screen.getByText('John Doe')).toBeInTheDocument();
+  });
+
+  // ❌ Incorrect - Testing implementation details
+  test('sets the text content', () => {
+    const { container } = render(<UserProfile user={{ name: 'John Doe' }} />);
+    expect(container.querySelector('h1').textContent).toBe('John Doe');
+  });
+  ```
+
+### Hook Testing
+- Use `renderHook` from @testing-library/react-hooks
+- Test all possible states
+  ```typescript
+  // ✅ Correct
+  test('useUser hook manages user state', () => {
+    const { result } = renderHook(() => useUser());
+    
+    act(() => {
+      result.current.setUser({ id: '1', name: 'John' });
+    });
+    
+    expect(result.current.user).toEqual({ id: '1', name: 'John' });
+  });
+  ```
+
+### Mocking
+- Mock external dependencies
+- Use jest.mock for module mocking
+  ```typescript
+  // ✅ Correct
+  jest.mock('~/services/api', () => ({
+    fetchUser: jest.fn().mockResolvedValue({ id: '1', name: 'John' }),
+  }));
+
+  test('fetches and displays user', async () => {
+    render(<UserProfile userId="1" />);
+    expect(await screen.findByText('John')).toBeInTheDocument();
+  });
+  ```
+
+## Integration Testing
+
+### API Testing
+- Test complete request/response cycles
+- Use Supertest for backend API testing
+  ```typescript
+  // ✅ Correct
+  describe('GET /api/users/:id', () => {
+    it('returns user when found', async () => {
+      const response = await request(app)
+        .get('/api/users/1')
+        .expect(200);
+      
+      expect(response.body).toEqual({
+        id: '1',
+        name: 'John Doe',
+      });
+    });
+
+    it('returns 404 when user not found', async () => {
+      await request(app)
+        .get('/api/users/999')
+        .expect(404);
+    });
+  });
+  ```
+
+## E2E Testing
+
+### Test Structure
+- Organize by user journey
+- Use page objects for reusability
+  ```typescript
+  // pages/login.ts
+  export class LoginPage {
+    async login(email: string, password: string) {
+      await this.page.fill('[data-testid="email-input"]', email);
+      await this.page.fill('[data-testid="password-input"]', password);
+      await this.page.click('[data-testid="login-button"]');
+    }
+  }
+
+  // tests/auth.spec.ts
+  test('user can login successfully', async ({ page }) => {
+    const loginPage = new LoginPage(page);
+    await loginPage.login('user@example.com', 'password');
+    await expect(page).toHaveURL('/dashboard');
+  });
+  ```
+
+### Test Data
+- Use dedicated test environments
+- Reset state between tests
+  ```typescript
+  // ✅ Correct
+  beforeEach(async () => {
+    await resetDatabase();
+    await seedTestData();
+  });
+
+  test('user workflow', async ({ page }) => {
+    // Test with clean, predictable state
+  });
+  ```
+
+## Visual Testing
+
+### Storybook Guidelines
+- Create stories for all components
+- Document component variants
+  ```typescript
+  // Button.stories.tsx
+  export default {
+    title: 'Components/Button',
+    component: Button,
+  } as Meta;
+
+  export const Primary = {
+    args: {
+      variant: 'primary',
+      label: 'Primary Button',
+    },
+  };
+
+  export const Secondary = {
+    args: {
+      variant: 'secondary',
+      label: 'Secondary Button',
+    },
+  };
+  ```
+
+### Visual Regression
+- Use Storybook's visual regression testing
+- Review changes carefully
+  ```typescript
+  // jest.config.js
+  module.exports = {
+    preset: 'jest-image-snapshot',
+    setupFilesAfterEnv: ['<rootDir>/setup-tests.ts'],
+  };
+
+  // Button.visual.test.tsx
+  describe('Button', () => {
+    it('matches visual snapshot', async () => {
+      const image = await page.screenshot();
+      expect(image).toMatchImageSnapshot();
+    });
+  });
+  ```
+
+## Test Quality
+
+### Test Data Attributes
+- Use data-testid for test selectors
+- Avoid selecting by CSS classes
+  ```typescript
+  // ✅ Correct
+  <button data-testid="submit-button">Submit</button>
+
+  // In tests
+  const button = screen.getByTestId('submit-button');
+
+  // ❌ Incorrect
+  const button = container.querySelector('.submit-btn');
+  ```
+
+### Assertion Best Practices
+- Use explicit assertions
+- Test both positive and negative cases
+  ```typescript
+  // ✅ Correct
+  test('form validation', async () => {
+    render(<UserForm />);
+    
+    // Negative case
+    await userEvent.click(screen.getByText('Submit'));
+    expect(screen.getByText('Name is required')).toBeInTheDocument();
+    
+    // Positive case
+    await userEvent.type(screen.getByLabelText('Name'), 'John Doe');
+    await userEvent.click(screen.getByText('Submit'));
+    expect(screen.queryByText('Name is required')).not.toBeInTheDocument();
+  });
+  ```
+
+### Coverage Requirements
+- A new feature should have at least 80% coverage
+- Focus on critical paths
+- Run coverage reports in CI
+  ```typescript
+  // jest.config.js
+  module.exports = {
+    coverageThreshold: {
+      global: {
+        statements: 80,
+        branches: 80,
+        functions: 80,
+        lines: 80,
+      },
+    },
+  };
+  ``` 

.cursor/rules/testing-guidelines.mdc

@@ -1,127 +0,0 @@
----
-description: Testing guidelines for Twenty CRM
-alwaysApply: false
----
-# Testing Guidelines
-
-## Test Structure (AAA Pattern)
-```typescript
-describe('UserService', () => {
-  describe('when getting user by ID', () => {
-    it('should return user data for valid ID', async () => {
-      // Arrange
-      const userId = '123';
-      const expectedUser = { id: '123', name: 'John' };
-      mockUserRepository.findById.mockResolvedValue(expectedUser);
-
-      // Act
-      const result = await userService.getUserById(userId);
-
-      // Assert
-      expect(result).toEqual(expectedUser);
-    });
-  });
-});
-```
-
-## React Component Testing
-```typescript
-// ✅ Test user behavior, not implementation
-describe('LoginForm', () => {
-  it('should display error message for invalid credentials', async () => {
-    const mockOnSubmit = jest.fn().mockRejectedValue(new Error('Invalid credentials'));
-    render(<LoginForm onSubmit={mockOnSubmit} />);
-
-    await user.type(screen.getByLabelText(/email/i), 'invalid@example.com');
-    await user.type(screen.getByLabelText(/password/i), 'wrongpassword');
-    await user.click(screen.getByRole('button', { name: /sign in/i }));
-
-    expect(await screen.findByText(/invalid credentials/i)).toBeInTheDocument();
-  });
-});
-```
-
-## Mocking Patterns
-```typescript
-// ✅ Service mocking
-const mockEmailService = {
-  sendEmail: jest.fn().mockResolvedValue({ success: true }),
-  validateEmail: jest.fn().mockReturnValue(true),
-};
-
-// ✅ Test data factories
-const createTestUser = (overrides = {}) => ({
-  id: uuid(),
-  email: 'test@example.com',
-  name: 'Test User',
-  ...overrides,
-});
-
-beforeEach(() => {
-  jest.clearAllMocks();
-});
-```
-
-## Testing Principles
-- **Test behavior, not implementation** - Focus on what users see/do
-- **Use descriptive test names** - "should [behavior] when [condition]"
-- **Query by user-visible elements** - text, roles, labels over test IDs
-- **Keep tests isolated** - Independent and repeatable
-- **70% unit, 20% integration, 10% E2E** - Test pyramid
-
-## Running Tests
-
-### Single Test File Execution
-```bash
-# ✅ Run a specific test file (PREFERRED - Fast & Efficient)
-npx jest path/to/test.test.ts --config=packages/PROJECT/jest.config.mjs
-
-# Key Benefits:
-# - Only runs the specific test file (fast)
-# - No dependency resolution overhead
-# - Immediate feedback for test development
-
-# ✅ Examples:
-# Frontend tests (use .test.ts extension)
-npx jest packages/twenty-front/src/modules/localization/utils/detection/detectNumberFormat.test.ts --config=packages/twenty-front/jest.config.mjs
-
-# Server tests (use .spec.ts extension)
-npx jest packages/twenty-server/src/utils/__test__/is-work-email.spec.ts --config=packages/twenty-server/jest.config.mjs
-
-# ❌ AVOID - This runs ALL tests (slow):
-npx nx test twenty-front --testPathPattern=detectNumberFormat.test.ts
-
-# ✅ Run tests in watch mode for development:
-npx jest path/to/test.test.ts --config=packages/twenty-front/jest.config.mjs --watch
-
-# ✅ Run with coverage for single file:
-npx jest path/to/test.test.ts --config=packages/twenty-front/jest.config.mjs --coverage
-```
-
-### Test Suite Execution
-```bash
-# Run all tests for a project (use sparingly)
-npx nx test twenty-front
-npx nx test twenty-server
-
-# Run tests matching a pattern
-npx jest --testNamePattern="UserService" --config=packages/twenty-front/jest.config.mjs
-```
-
-## Common Patterns
-```typescript
-// Async testing
-await waitFor(() => {
-  expect(screen.getByText('Loading...')).not.toBeInTheDocument();
-});
-
-// User interactions
-await user.click(screen.getByRole('button'));
-await user.type(screen.getByLabelText(/search/i), 'query');
-
-// API integration tests
-const response = await request(app)
-  .post('/api/users')
-  .send(userData)
-  .expect(201);
-```

.cursor/rules/translations.md

@@ -0,0 +1,162 @@
+# Translation Guidelines
+
+## Core Translation Principles
+Twenty uses Lingui for internationalization (i18n) and Crowdin for translation management. This document outlines our translation workflow and best practices.
+
+## Technology Stack
+
+### Translation Tools
+- **Framework**: @lingui/react
+- **Translation Management**: Crowdin
+- **Workflow**: GitHub Actions for automation
+
+### Package Structure
+Translation files are managed in multiple packages:
+- `twenty-front`: Frontend translations
+- `twenty-server`: Backend translations
+- `twenty-emails`: Email template translations
+
+## Translation Process
+
+### Adding New Strings
+
+#### Using Lingui Macros
+- Use `<Trans>` for components
+- Use `t` macro for strings outside JSX
+  ```typescript
+  // ✅ Correct - In JSX
+  import { Trans } from '@lingui/react/macro';
+  
+  const WelcomeMessage = () => (
+    <h1>
+      <Trans>Welcome to Twenty</Trans>
+    </h1>
+  );
+
+  // ✅ Correct - Outside JSX
+  import { t } from '@lingui/react/macro';
+  
+  const getMessage = () => {
+    return t`Welcome to Twenty`;
+  };
+
+  // ❌ Incorrect - Don't use raw strings
+  const WelcomeMessage = () => (
+    <h1>Welcome to Twenty</h1>
+  );
+  ```
+
+### String Guidelines
+
+#### What to Translate
+- User interface text
+- Error messages
+- Notifications
+- Email content
+
+#### What Not to Translate
+- Variables
+- Test data/mocks
+
+### Translation Workflow
+
+#### 1. Extracting Translations
+- Automatically triggered on main branch changes
+- Can be manually triggered in GitHub Actions
+- Process:
+  ```bash
+  # Extract new strings
+  nx run twenty-front:lingui:extract
+  nx run twenty-server:lingui:extract
+  nx run twenty-emails:lingui:extract
+  ```
+
+#### 2. Translation Management
+- Translations are managed in Crowdin
+- Changes are synced every 2 hours
+- Process:
+  1. New strings are uploaded to Crowdin
+  2. Translators work on translations
+  3. Translations are pulled back to the repository
+
+#### 3. Compiling Translations
+- Happens automatically in CI/CD
+- Required before running the application
+  ```bash
+  # Compile translations
+  nx run twenty-front:lingui:compile
+  nx run twenty-server:lingui:compile
+  nx run twenty-emails:lingui:compile
+  ```
+
+## Best Practices
+
+### String Management
+
+#### Use Placeholders
+- Use placeholders for dynamic content
+  ```typescript
+  // ✅ Correct
+  <Trans>Hello {userName},</Trans>
+
+  // ❌ Incorrect - String concatenation
+  <Trans>Hello </Trans>{userName},
+  ```
+
+#### Provide Context
+- Lingui provides powerfulway to add context for translators but we don't use them as of today.
+
+### Code Organization
+
+#### Translation Files
+- Keep translation files organized by feature
+- Use consistent naming patterns
+  ```
+  src/
+  ├── locales/
+  │   ├── en/
+  │   │   ├── messages.po
+  │   │   └── messages.js
+  │   └── fr/
+  │       ├── messages.po
+  │       └── messages.js
+  ```
+
+### Quality Assurance
+
+#### Strict Mode
+- Use --strict mode when compiling to identify missing translations
+
+
+#### Testing Translations
+- Test with different locales
+- Verify string interpolation
+- Check layout with different language lengths
+
+## Automation
+
+### GitHub Actions
+
+#### Pull Workflow
+- Runs every 2 hours
+- Downloads new translations from Crowdin
+- Creates PR if changes detected
+- Can be manually triggered with force pull option
+
+#### Push Workflow
+- Runs on main branch changes
+- Extracts and uploads new strings
+- Compiles translations
+- Creates PR with changes
+
+### Error Handling
+
+#### Missing Translations
+- Development: Shown in original language
+- Production: Falls back to default language
+- Strict mode in CI catches missing translations
+
+#### Compilation Errors
+- Addressed before merging
+- PR created for fixing missing translations
+- Automated testing in CI pipeline 

.cursor/rules/translations.mdc

@@ -1,290 +0,0 @@
----
-description: Translation guidelines for Twenty CRM
-alwaysApply: false
----
-# Translation Guidelines
-
-## Internationalization (i18n) Overview
-
-### Supported Languages
-- English (en) - Primary language
-- French (fr) - Secondary language
-- German (de) - Planned
-- Spanish (es) - Planned
-- Additional languages based on community contributions
-
-### i18n Architecture
-- Use react-i18next for React components
-- Store translations in JSON files
-- Implement namespace-based organization
-- Support for interpolation and pluralization
-
-## File Structure
-
-### Translation Files
-```
-src/locales/
-├── en/                        # English translations
-│   ├── common.json           # Common UI strings
-│   ├── auth.json             # Authentication strings
-│   ├── dashboard.json        # Dashboard specific
-│   ├── forms.json            # Form labels and validation
-│   └── errors.json           # Error messages
-├── fr/                       # French translations
-│   ├── common.json
-│   ├── auth.json
-│   └── ...
-└── index.ts                  # i18n configuration
-```
-
-### Translation Keys
-- Use nested objects for organization
-- Follow consistent naming patterns
-- Include context in key names
-  ```json
-  {
-    "auth": {
-      "login": {
-        "title": "Sign In",
-        "email": "Email Address",
-        "password": "Password",
-        "submit": "Sign In",
-        "forgotPassword": "Forgot Password?"
-      },
-      "register": {
-        "title": "Create Account",
-        "confirmPassword": "Confirm Password"
-      }
-    }
-  }
-  ```
-
-## Translation Implementation
-
-### React Components
-- Use useTranslation hook
-- Specify namespaces for better organization
-- Handle loading states properly
-  ```typescript
-  // ✅ Correct
-  import { useTranslation } from 'react-i18next';
-
-  const LoginForm = () => {
-    const { t } = useTranslation('auth');
-
-    return (
-      <form>
-        <h1>{t('login.title')}</h1>
-        <input 
-          placeholder={t('login.email')}
-          type="email"
-        />
-        <input 
-          placeholder={t('login.password')}
-          type="password"
-        />
-        <button type="submit">
-          {t('login.submit')}
-        </button>
-      </form>
-    );
-  };
-  ```
-
-### Interpolation
-- Use interpolation for dynamic content
-- Pass variables through t() function
-- Keep interpolation simple and readable
-  ```typescript
-  // ✅ Correct
-  const WelcomeMessage = ({ userName }: { userName: string }) => {
-    const { t } = useTranslation('common');
-    
-    return (
-      <h1>{t('welcome.message', { name: userName })}</h1>
-    );
-  };
-
-  // Translation file
-  {
-    "welcome": {
-      "message": "Welcome back, {{name}}!"
-    }
-  }
-  ```
-
-### Pluralization
-- Handle singular/plural forms correctly
-- Use count-based pluralization
-- Support different plural rules per language
-  ```typescript
-  // ✅ Correct
-  const ItemCount = ({ count }: { count: number }) => {
-    const { t } = useTranslation('common');
-    
-    return (
-      <span>{t('items.count', { count })}</span>
-    );
-  };
-
-  // Translation file
-  {
-    "items": {
-      "count_one": "{{count}} item",
-      "count_other": "{{count}} items"
-    }
-  }
-  ```
-
-## Translation Management
-
-### Adding New Strings
-1. Add English translation first
-2. Use descriptive keys that indicate context
-3. Include comments for translators when needed
-4. Test with long translations to ensure UI flexibility
-  ```json
-  {
-    "user": {
-      "profile": {
-        // Displayed in user profile header
-        "displayName": "Display Name",
-        // Used in forms when editing profile
-        "editDisplayName": "Edit Display Name",
-        // Confirmation message after profile update
-        "updateSuccess": "Profile updated successfully"
-      }
-    }
-  }
-  ```
-
-### Translation Validation
-- Use TypeScript for translation key validation
-- Implement automated checks for missing translations
-- Validate interpolation parameters
-  ```typescript
-  // ✅ Correct - Type-safe translations
-  type TranslationKey = 
-    | 'auth.login.title'
-    | 'auth.login.email'
-    | 'auth.login.password'
-    | 'common.welcome.message';
-
-  const t = (key: TranslationKey, options?: any) => {
-    // Translation implementation
-  };
-  ```
-
-## Best Practices
-
-### Key Naming
-- Use descriptive, hierarchical keys
-- Avoid abbreviations
-- Group related translations
-- Keep keys consistent across languages
-  ```json
-  // ✅ Correct
-  {
-    "dashboard": {
-      "header": {
-        "title": "Dashboard",
-        "subtitle": "Welcome to your workspace"
-      },
-      "actions": {
-        "createNew": "Create New",
-        "refresh": "Refresh Data",
-        "export": "Export"
-      }
-    }
-  }
-
-  // ❌ Incorrect
-  {
-    "dash_title": "Dashboard",
-    "newBtn": "New",
-    "refreshData": "Refresh"
-  }
-  ```
-
-### String Guidelines
-- Write clear, concise text
-- Use consistent terminology
-- Consider character limits for UI elements
-- Avoid concatenating translated strings
-  ```json
-  // ✅ Correct
-  {
-    "user": {
-      "status": {
-        "online": "Online",
-        "offline": "Offline",
-        "away": "Away"
-      }
-    }
-  }
-
-  // ❌ Incorrect - Don't concatenate
-  {
-    "user": {
-      "statusPrefix": "User is ",
-      "statusOnline": "online"
-    }
-  }
-  ```
-
-### Context Information
-- Provide context for translators
-- Include character limits when relevant
-- Explain when/where text appears
-- Note any technical constraints
-  ```json
-  {
-    "button": {
-      // Primary action button, max 20 characters
-      "save": "Save Changes",
-      // Secondary button in modal footer
-      "cancel": "Cancel",
-      // Destructive action, should sound cautious
-      "delete": "Delete Permanently"
-    }
-  }
-  ```
-
-## Workflow
-
-### Development Process
-1. Develop features with English translations
-2. Use placeholder keys during development
-3. Finalize translation keys before feature completion
-4. Add translations to all supported languages
-5. Test with different language strings
-
-### Translation Updates
-1. Create translation tasks for new features
-2. Provide context and screenshots to translators
-3. Review translations for consistency
-4. Test UI with translated strings
-5. Update documentation when needed
-
-### Quality Assurance
-- Review translations in context
-- Test with longest expected translations
-- Verify formatting with interpolation
-- Check for cultural appropriateness
-- Ensure accessibility with screen readers
-
-## Maintenance
-
-### Regular Tasks
-- Review and update outdated translations
-- Check for unused translation keys
-- Maintain consistency across languages
-- Update translation documentation
-- Monitor for missing translations in new features
-
-### Tools and Automation
-- Use automated translation validation
-- Implement missing translation detection
-- Set up continuous integration checks
-- Maintain translation coverage reports
-- Use translation management platforms when needed

.cursor/rules/typescript-guidelines.md

@@ -0,0 +1,172 @@
+# TypeScript Guidelines
+
+## Core TypeScript Principles
+Twenty enforces strict TypeScript usage to ensure type safety and maintainable code. This document outlines our TypeScript conventions and best practices.
+
+## Type Safety
+
+### Strict Typing
+- **No 'any' type allowed**
+- TypeScript strict mode enabled
+- noImplicitAny enabled
+  ```typescript
+  // ✅ Correct
+  function processUser(user: User) {
+    return user.name;
+  }
+
+  // ❌ Incorrect
+  function processUser(user: any) {
+    return user.name;
+  }
+  ```
+
+### Type Definitions
+
+#### Types over Interfaces
+- Use `type` for all type definitions
+- Exception: When extending third-party interfaces
+  ```typescript
+  // ✅ Correct
+  type User = {
+    id: string;
+    name: string;
+    email: string;
+  };
+
+  // ❌ Incorrect
+  interface User {
+    id: string;
+    name: string;
+    email: string;
+  }
+  ```
+
+### String Literals over Enums
+- Use string literal unions instead of enums
+- Exception: GraphQL enums
+  ```typescript
+  // ✅ Correct
+  type UserRole = 'admin' | 'user' | 'guest';
+
+  // ❌ Incorrect
+  enum UserRole {
+    Admin = 'admin',
+    User = 'user',
+    Guest = 'guest',
+  }
+  ```
+
+## Naming Conventions
+
+### Component Props
+- Suffix component prop types with 'Props'
+- Keep props focused and single-purpose
+  ```typescript
+  // ✅ Correct
+  type ButtonProps = {
+    label: string;
+    onClick: () => void;
+    variant?: 'primary' | 'secondary';
+  };
+
+  // ❌ Incorrect
+  type ButtonParameters = {
+    label: string;
+    onClick: () => void;
+    variant?: 'primary' | 'secondary';
+  };
+  ```
+
+## Type Inference
+
+### Leverage TypeScript Inference
+- Use type inference when types are clear
+- Explicitly type when inference is ambiguous
+  ```typescript
+  // ✅ Correct - Clear inference
+  const users = ['John', 'Jane']; // inferred as string[]
+
+  // ✅ Correct - Explicit typing needed
+  const processUser = (user: User): UserResponse => {
+    // Complex processing
+    return response;
+  };
+
+  // ❌ Incorrect - Unnecessary explicit typing
+  const users: string[] = ['John', 'Jane'];
+  ```
+
+## Best Practices
+
+### Type Guards
+- Use type guards for runtime type checking
+- Prefer discriminated unions
+  ```typescript
+  // ✅ Correct
+  type Success = {
+    type: 'success';
+    data: User;
+  };
+
+  type Error = {
+    type: 'error';
+    message: string;
+  };
+
+  type Result = Success | Error;
+
+  function handleResult(result: Result) {
+    if (result.type === 'success') {
+      // TypeScript knows result.data exists
+      console.log(result.data);
+    }
+  }
+  ```
+
+### Generics
+- Use generics for reusable type patterns
+- Keep generic names descriptive
+  ```typescript
+  // ✅ Correct
+  type ApiResponse<TData> = {
+    data: TData;
+    status: number;
+    message: string;
+  };
+
+  // ❌ Incorrect
+  type ApiResponse<T> = {
+    data: T;
+    status: number;
+    message: string;
+  };
+  ```
+
+### Type Exports
+- Export types when they're used across files
+- Keep type definitions close to their usage
+  ```typescript
+  // types.ts
+  export type User = {
+    id: string;
+    name: string;
+  };
+
+  // UserComponent.tsx
+  import { type User } from './types';
+  ```
+
+### Utility Types
+- Leverage TypeScript utility types
+- Create custom utility types for repeated patterns
+  ```typescript
+  // Built-in utility types
+  type UserPartial = Partial<User>;
+  type UserReadonly = Readonly<User>;
+
+  // Custom utility types
+  type NonNullableProperties<T> = {
+    [P in keyof T]: NonNullable<T[P]>;
+  };
+  ``` 

.cursor/rules/typescript-guidelines.mdc

@@ -1,182 +0,0 @@
----
-description: TypeScript best practices and conventions for the Twenty codebase, including strict typing, naming conventions, and type safety guidelines.
-alwaysApply: false
----
----
-description: TypeScript best practices and conventions for the Twenty codebase, including strict typing, naming conventions, and type safety guidelines.
-globs: ["**/*.ts", "**/*.tsx"]
-alwaysApply: false
----
-
-# TypeScript Guidelines
-
-## Core TypeScript Principles
-Twenty enforces strict TypeScript usage to ensure type safety and maintainable code. This document outlines our TypeScript conventions and best practices.
-
-## Type Safety
-
-### Strict Typing
-- **No 'any' type allowed**
-- TypeScript strict mode enabled
-- noImplicitAny enabled
-  ```typescript
-  // ✅ Correct
-  function processUser(user: User) {
-    return user.name;
-  }
-
-  // ❌ Incorrect
-  function processUser(user: any) {
-    return user.name;
-  }
-  ```
-
-### Type Definitions
-
-#### Types over Interfaces
-- Use `type` for all type definitions
-- Exception: When extending third-party interfaces
-  ```typescript
-  // ✅ Correct
-  type User = {
-    id: string;
-    name: string;
-    email: string;
-  };
-
-  // ❌ Incorrect
-  interface User {
-    id: string;
-    name: string;
-    email: string;
-  }
-  ```
-
-### String Literals over Enums
-- Use string literal unions instead of enums
-- Exception: GraphQL enums
-  ```typescript
-  // ✅ Correct
-  type UserRole = 'admin' | 'user' | 'guest';
-
-  // ❌ Incorrect
-  enum UserRole {
-    Admin = 'admin',
-    User = 'user',
-    Guest = 'guest',
-  }
-  ```
-
-## Naming Conventions
-
-### Component Props
-- Suffix component prop types with 'Props'
-- Keep props focused and single-purpose
-  ```typescript
-  // ✅ Correct
-  type ButtonProps = {
-    label: string;
-    onClick: () => void;
-    variant?: 'primary' | 'secondary';
-  };
-
-  // ❌ Incorrect
-  type ButtonParameters = {
-    label: string;
-    onClick: () => void;
-    variant?: 'primary' | 'secondary';
-  };
-  ```
-
-## Type Inference
-
-### Leverage TypeScript Inference
-- Use type inference when types are clear
-- Explicitly type when inference is ambiguous
-  ```typescript
-  // ✅ Correct - Clear inference
-  const users = ['John', 'Jane']; // inferred as string[]
-
-  // ✅ Correct - Explicit typing needed
-  const processUser = (user: User): UserResponse => {
-    // Complex processing
-    return response;
-  };
-
-  // ❌ Incorrect - Unnecessary explicit typing
-  const users: string[] = ['John', 'Jane'];
-  ```
-
-## Best Practices
-
-### Type Guards
-- Use type guards for runtime type checking
-- Prefer discriminated unions
-  ```typescript
-  // ✅ Correct
-  type Success = {
-    type: 'success';
-    data: User;
-  };
-
-  type Error = {
-    type: 'error';
-    message: string;
-  };
-
-  type Result = Success | Error;
-
-  function handleResult(result: Result) {
-    if (result.type === 'success') {
-      // TypeScript knows result.data exists
-      console.log(result.data);
-    }
-  }
-  ```
-
-### Generics
-- Use generics for reusable type patterns
-- Keep generic names descriptive
-  ```typescript
-  // ✅ Correct
-  type ApiResponse<TData> = {
-    data: TData;
-    status: number;
-    message: string;
-  };
-
-  // ❌ Incorrect
-  type ApiResponse<T> = {
-    data: T;
-    status: number;
-    message: string;
-  };
-  ```
-
-### Type Exports
-- Export types when they're used across files
-- Keep type definitions close to their usage
-  ```typescript
-  // types.ts
-  export type User = {
-    id: string;
-    name: string;
-  };
-
-  // UserComponent.tsx
-  import { type User } from './types';
-  ```
-
-### Utility Types
-- Leverage TypeScript utility types
-- Create custom utility types for repeated patterns
-  ```typescript
-  // Built-in utility types
-  type UserPartial = Partial<User>;
-  type UserReadonly = Readonly<User>;
-
-  // Custom utility types
-  type NonNullableProperties<T> = {
-    [P in keyof T]: NonNullable<T[P]>;
-  };
-  ```

.cursor/worktrees.json

@@ -1,8 +0,0 @@
-{
-  "setup-worktree": [
-    "nvm use",
-    "yarn",
-    "cp $ROOT_WORKTREE_PATH/packages/twenty-server/.env packages/twenty-server/.env || true",
-    "cp $ROOT_WORKTREE_PATH/packages/twenty-front/.env packages/twenty-front/.env || true"
-  ]
-}

.dockerignore

@@ -2,4 +2,3 @@
 .env
 node_modules
 .nx/cache
-packages/twenty-server/.env

.eslintrc.cjs

@@ -0,0 +1,148 @@
+module.exports = {
+  root: true,
+  extends: ['plugin:prettier/recommended', 'plugin:lingui/recommended'],
+  plugins: [
+    '@nx',
+    'prefer-arrow',
+    'import',
+    'unused-imports',
+    'unicorn',
+    'lingui',
+  ],
+  rules: {
+    'lingui/no-single-variables-to-translate': 'off',
+    'func-style': ['error', 'declaration', { allowArrowFunctions: true }],
+    'no-console': ['warn', { allow: ['group', 'groupCollapsed', 'groupEnd'] }],
+    'no-control-regex': 0,
+    'no-debugger': 'error',
+    'no-duplicate-imports': 'error',
+    'no-undef': 'off',
+    'no-unused-vars': 'off',
+
+    '@nx/enforce-module-boundaries': [
+      'error',
+      {
+        enforceBuildableLibDependency: true,
+        allow: [],
+        depConstraints: [
+          {
+            sourceTag: 'scope:shared',
+            onlyDependOnLibsWithTags: ['scope:shared'],
+          },
+          {
+            sourceTag: 'scope:backend',
+            onlyDependOnLibsWithTags: ['scope:shared', 'scope:backend'],
+          },
+          {
+            sourceTag: 'scope:frontend',
+            onlyDependOnLibsWithTags: ['scope:shared', 'scope:frontend'],
+          },
+          {
+            sourceTag: 'scope:zapier',
+            onlyDependOnLibsWithTags: ['scope:shared'],
+          },
+        ],
+      },
+    ],
+
+    'import/no-relative-packages': 'error',
+    'import/no-useless-path-segments': 'error',
+    'import/no-duplicates': ['error', { considerQueryString: true }],
+
+    'prefer-arrow/prefer-arrow-functions': [
+      'error',
+      {
+        disallowPrototype: true,
+        singleReturnOnly: false,
+        classPropertiesAllowed: false,
+      },
+    ],
+
+    'unused-imports/no-unused-imports': 'warn',
+    'unused-imports/no-unused-vars': [
+      'warn',
+      {
+        vars: 'all',
+        varsIgnorePattern: '^_',
+        args: 'after-used',
+        argsIgnorePattern: '^_',
+      },
+    ],
+  },
+  overrides: [
+    {
+      files: ['**/*.ts', '**/*.tsx'],
+      extends: ['plugin:@nx/typescript'],
+      rules: {
+        '@typescript-eslint/ban-ts-comment': 'error',
+        '@typescript-eslint/consistent-type-imports': [
+          'error',
+          { prefer: 'no-type-imports' },
+        ],
+        '@typescript-eslint/explicit-function-return-type': 'off',
+        '@typescript-eslint/explicit-module-boundary-types': 'off',
+        '@typescript-eslint/interface-name-prefix': 'off',
+        '@typescript-eslint/no-empty-interface': [
+          'error',
+          {
+            allowSingleExtends: true,
+          },
+        ],
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/no-empty-function': 'off',
+        '@typescript-eslint/no-unused-vars': [
+          'warn',
+          {
+            vars: 'all',
+            varsIgnorePattern: '^_',
+            args: 'after-used',
+            argsIgnorePattern: '^_',
+          },
+        ],
+      },
+    },
+    {
+      files: ['*.js', '*.jsx'],
+      extends: ['plugin:@nx/javascript'],
+      rules: {},
+    },
+    {
+      files: [
+        '*.spec.@(ts|tsx|js|jsx)',
+        '*.integration-spec.@(ts|tsx|js|jsx)',
+        '*.test.@(ts|tsx|js|jsx)',
+      ],
+      env: {
+        jest: true,
+      },
+      rules: {
+        '@typescript-eslint/no-non-null-assertion': 'off',
+      },
+    },
+    {
+      files: ['**/constants/*.ts', '**/*.constants.ts'],
+      rules: {
+        '@typescript-eslint/naming-convention': [
+          'error',
+          {
+            selector: 'variable',
+            format: ['UPPER_CASE'],
+          },
+        ],
+        'unicorn/filename-case': [
+          'warn',
+          {
+            cases: {
+              pascalCase: true,
+            },
+          },
+        ],
+        '@nx/workspace-max-consts-per-file': ['error', { max: 1 }],
+      },
+    },
+    {
+      files: ['*.json'],
+      parser: 'jsonc-eslint-parser',
+    },
+  ],
+};

.eslintrc.react.cjs

@@ -0,0 +1,90 @@
+var path = require('path');
+
+module.exports = {
+  extends: [
+    'plugin:@nx/react',
+    'plugin:react/recommended',
+    'plugin:react-hooks/recommended',
+    'plugin:storybook/recommended',
+  ],
+  plugins: ['react-hooks', 'react-refresh'],
+  overrides: [
+    {
+      files: ['*.ts', '*.tsx'],
+      parserOptions: {
+        project: ['./tsconfig.base.{json,*.json}'],
+      },
+      rules: {
+        'no-restricted-imports': [
+          'error',
+          {
+            patterns: [
+              {
+                group: ['@tabler/icons-react'],
+                message: 'Please import icons from `twenty-ui`',
+              },
+              {
+                group: ['react-hotkeys-web-hook'],
+                importNames: ['useHotkeys'],
+                message:
+                  'Please use the custom wrapper: `useScopedHotkeys` from `twenty-ui`',
+              },
+              {
+                group: ['lodash'],
+                message:
+                  "Please use the standalone lodash package (for instance: `import groupBy from 'lodash.groupby'` instead of `import { groupBy } from 'lodash'`)",
+              },
+            ],
+          },
+        ],
+        '@nx/workspace-effect-components': 'error',
+        '@nx/workspace-no-hardcoded-colors': 'error',
+        '@nx/workspace-matching-state-variable': 'error',
+        '@nx/workspace-sort-css-properties-alphabetically': 'error',
+        '@nx/workspace-styled-components-prefixed-with-styled': 'error',
+        '@nx/workspace-no-state-useref': 'error',
+        '@nx/workspace-component-props-naming': 'error',
+        '@nx/workspace-explicit-boolean-predicates-in-if': 'error',
+        '@nx/workspace-use-getLoadable-and-getValue-to-get-atoms': 'error',
+        '@nx/workspace-useRecoilCallback-has-dependency-array': 'error',
+        '@nx/workspace-no-navigate-prefer-link': 'error',
+        'react/no-unescaped-entities': 'off',
+        'react/prop-types': 'off',
+        'react/jsx-key': 'off',
+        'react/display-name': 'off',
+        'react/jsx-uses-react': 'off',
+        'react/react-in-jsx-scope': 'off',
+        'react/jsx-no-useless-fragment': 'off',
+        'react/jsx-props-no-spreading': [
+          'error',
+          {
+            explicitSpread: 'ignore',
+          },
+        ],
+        'react-hooks/exhaustive-deps': [
+          'warn',
+          {
+            additionalHooks: 'useRecoilCallback',
+          },
+        ],
+      },
+    },
+    {
+      files: ['*.stories.@(ts|tsx|js|jsx)'],
+      rules: {
+        '@typescript-eslint/no-non-null-assertion': 'off',
+      },
+    },
+    {
+      files: ['.storybook/main.@(js|cjs|mjs|ts)'],
+      rules: {
+        'storybook/no-uninstalled-addons': [
+          'error',
+          {
+            packageJsonLocation: path.resolve(__dirname, './package.json'),
+          },
+        ],
+      },
+    },
+  ],
+};

.gitattributes

@@ -1,28 +0,0 @@
-* text=auto eol=lf
-
-*.ts text eol=lf
-*.tsx text eol=lf
-*.js text eol=lf
-*.jsx text eol=lf
-*.json text eol=lf
-*.md text eol=lf
-*.yml text eol=lf
-*.yaml text eol=lf
-*.sh text eol=lf
-*.mjs text eol=lf
-*.cjs text eol=lf
-
-# Patch files may have mixed line endings by design
-*.patch -text
-
-*.png binary
-*.jpg binary
-*.jpeg binary
-*.gif binary
-*.ico binary
-*.svg binary
-*.woff binary
-*.woff2 binary
-*.ttf binary
-*.eot binary
-

.github/CONTRIBUTING.md

@@ -1,22 +1,26 @@
 # Contributing to Twenty
 
-Thanks for considering contributing to Twenty!
+Thanks for considering contributing to Twenty! 
 
-Please make sure to go through the [documentation](https://docs.twenty.com) before.
+Please make sure to go through the [documentation](https://docs.twenty.com) before. 
 
 <br>
 
 
 ## Good first issues
 
-Good first issues are a great way to start contributing and get familiar with the codebase. You can find them on by filtering on the [good first issue](https://github.com/twentyhq/twenty/labels/good%20first%20issue) label.
+Good first issues are a great way to start contributing and get familiar with the codebase. You can find them on by filtering on the [good first issue](https://github.com/twentyhq/twenty/labels/good%20first%20issue) label. 
 
 ## Issue assignment
 
-To avoid conflicts, we follow these guidelines:
+Having multiple contributors address the same issue can cause frustration.
 
-1. For `Good First Issue` and `Experienced Contributor` issues without `size: long` labels, we'll merge the first PRs that meet our [code quality standards](https://docs.twenty.com/developers). **We don't assign contributors to these issues**. For `priority: high` issues, our core team will step in within days if no adequate contributions are received.
-2. For `size: long` Issues, assigned contributors have one week to submit their first draft PR.
+To avoid conflicts, we follow these guidelines:
+1. If a core team member assigned you the issue within the last three days, your PR takes priority.
+2. Otherwise, the first submitted PR is prioritized.
+3. For "size: long" PRs, the assignment period extends to one week.
+
+Please ensure you're assigned to an issue before starting work.
 
 ## How to Contribute
 
@@ -63,4 +67,4 @@ git push origin your-branch-name
 
 ## Reporting Issues
 
-If you face any issues or have suggestions, please feel free to [create an issue on Twenty's GitHub repository](https://github.com/twentyhq/twenty/issues/new). Please provide as much detail as possible.
+If you face any issues or have suggestions, please feel free to (create an issue on Twenty's GitHub repository)[https://github.com/twentyhq/twenty/issues/new]. Please provide as much detail as possible.

.github/ISSUE_TEMPLATE/request-technical-work.md

@@ -27,7 +27,7 @@ Having a list that is draggable will be useful, not only in dropdown.
 
 Create a folder @/ui/draggable-list with a DraggableList component
 This component should take as prop: itemsComponents, onDragEnd((previousIndex, nextIndex) => {})
-Use this component in ObjectOptionsDropdownHiddenFieldsContent (move the logic from ObjectOptionsDropdownHiddenFieldsContent to DraggableList) by passing a list of DraggableMenuItems
+Use this component in ViewFieldsVisibilityDropdownSection (move the logic from ViewFieldsVisibilityDropdownSection to DraggableList) by passing a list of DraggableMenuItems
 Add a storybook test on this list (we don't know how to actually test the draggable behavior, but we can at least make sure the component renders correctly a list of items)
 ```
 

.github/actions/nx-affected/action.yaml

@@ -1,22 +0,0 @@
-name: Nx Affected CI
-inputs:
-  parallel:
-    required: false
-    default: '3'
-  tag:
-    required: false
-  tasks:
-    required: true
-  configuration:
-    required: false
-    default: 'ci'
-  args:
-    required: false
-runs:
-  using: "composite"
-  steps:
-    - name: Get last successful commit
-      uses: nrwl/nx-set-shas@v4
-    - name: Run affected command
-      shell: bash
-      run: npx nx affected --nxBail --configuration=${{ inputs.configuration }} -t=${{ inputs.tasks }} --parallel=${{ inputs.parallel }} --exclude='*,!tag:${{ inputs.tag }}' ${{ inputs.args }}

.github/actions/restore-cache/action.yaml

@@ -1,35 +0,0 @@
-name: Restore cache
-inputs:
-  key:
-    required: true
-    description: Prefix to the cache key
-  additional-paths:
-    required: false
-outputs:
-  cache-primary-key:
-    description: actions/cache/restore cache-primary-key outputs proxy
-    value: ${{ steps.restore-cache.outputs.cache-primary-key }}
-  cache-hit:
-    description: String bool indicating whether cache has been directly or indirectly hit
-    value: ${{ steps.restore-cache.outputs.cache-hit == 'true' || steps.restore-cache.outputs.cache-matched-key != '' }}
-
-runs:
-  using: composite
-  steps:
-    - name: Cache primary key builder
-      id: cache-primary-key-builder
-      shell: bash
-      run: |
-        echo "CACHE_PRIMARY_KEY_PREFIX=v4-${{ inputs.key }}-${{ github.ref_name }}" >> "${GITHUB_OUTPUT}"
-    - name: Restore cache
-      uses: actions/cache/restore@v4
-      id: restore-cache
-      with:
-        key: ${{ steps.cache-primary-key-builder.outputs.CACHE_PRIMARY_KEY_PREFIX }}-${{ github.sha }}
-        restore-keys: ${{ steps.cache-primary-key-builder.outputs.CACHE_PRIMARY_KEY_PREFIX }}-
-        path: |
-          .cache
-          .nx
-          node_modules/.cache
-          packages/*/node_modules/.cache
-          ${{ inputs.additional-paths }}

.github/actions/save-cache/action.yaml

@@ -1,21 +0,0 @@
-name: Save cache
-inputs:
-  key:
-    required: true
-    description: Primary key to the cache, should be retrieved from `cache-restore` composite action outputs.
-  additional-paths:
-    required: false
-
-runs:
-  using: "composite"
-  steps:
-    - name: Save cache
-      uses: actions/cache/save@v4
-      with:
-        key: ${{ inputs.key }}
-        path: |
-          .cache
-          .nx
-          node_modules/.cache
-          packages/*/node_modules/.cache
-          ${{ inputs.additional-paths }}

.github/actions/yarn-install/action.yaml

@@ -1,42 +0,0 @@
-name: Yarn Install
-inputs:
-  node-version:
-    required: false
-    default: '24'
-
-runs:
-  using: 'composite'
-  steps:
-    - name: Cache primary key builder
-      id: globals
-      shell: bash
-      run: |
-        echo "ACTION_SHELL=bash" >> "${GITHUB_OUTPUT}"
-        echo "CACHE_KEY_PREFIX=node_modules-cache-node-${{ inputs.node-version }}-${{ hashFiles('yarn.lock') }}"  >> "${GITHUB_OUTPUT}"
-        echo 'PATH_TO_CACHE<<EOF' >> $GITHUB_OUTPUT
-        echo "node_modules" >> $GITHUB_OUTPUT
-        echo "packages/*/node_modules" >> $GITHUB_OUTPUT
-        echo 'EOF' >> $GITHUB_OUTPUT
-    - name: Setup Node.js and get yarn cache
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ inputs.node-version }}
-    - name: Restore node_modules
-      id: cache-node-modules
-      uses: actions/cache/restore@v4
-      with:
-        key: v4-${{ steps.globals.outputs.CACHE_KEY_PREFIX }}-${{github.sha}}
-        restore-keys: v4-${{ steps.globals.outputs.CACHE_KEY_PREFIX }}-
-        path: ${{ steps.globals.outputs.PATH_TO_CACHE }}
-    - name: Install Dependencies
-      if: ${{ steps.cache-node-modules.outputs.cache-hit != 'true' && steps.cache-node-modules.outputs.cache-matched-key == '' }}
-      shell: ${{ steps.globals.outputs.ACTION_SHELL }}
-      run: |
-        yarn config set enableHardenedMode true
-        yarn --immutable --check-cache
-    - name: Save cache
-      if: ${{ steps.cache-node-modules.outputs.cache-hit != 'true' && steps.cache-node-modules.outputs.cache-matched-key == '' }}
-      uses: actions/cache/save@v4
-      with:
-        key: ${{ steps.cache-node-modules.outputs.cache-primary-key }}
-        path: ${{ steps.globals.outputs.PATH_TO_CACHE }}

.github/crowdin-app.yml

@@ -1,23 +0,0 @@
-#
-# Crowdin CLI configuration for App translations (twenty-front, twenty-server, twenty-emails)
-# Project ID: 1
-# See https://crowdin.github.io/crowdin-cli/configuration for more information
-#
-
-"preserve_hierarchy": true
-"base_path": ".."
-
-files: [
-  {
-    #
-    # Source files filter - PO files for Lingui
-    #
-    "source": "**/en.po",
-
-    #
-    # Translation files path
-    #
-    "translation": "%original_path%/%locale%.po",
-  }
-]
-

.github/crowdin-docs.yml

@@ -1,45 +0,0 @@
-#
-# Crowdin CLI configuration for Documentation translations
-# See https://crowdin.github.io/crowdin-cli/configuration for more information
-#
-
-"project_id": 2
-"preserve_hierarchy": true
-"base_url": "https://twenty.api.crowdin.com"
-"base_path": ".."
-
-files: [
-  {
-    #
-    # MDX documentation files - user-guide
-    # Using md type to preserve JSX component structure
-    # This prevents Crowdin from reformatting <Warning>, <Accordion>, etc.
-    #
-    "source": "packages/twenty-docs/user-guide/**/*.mdx",
-    "translation": "packages/twenty-docs/l/%two_letters_code%/user-guide/**/%original_file_name%",
-  },
-  {
-    #
-    # MDX documentation files - developers
-    # Using md type to preserve JSX component structure
-    #
-    "source": "packages/twenty-docs/developers/**/*.mdx",
-    "translation": "packages/twenty-docs/l/%two_letters_code%/developers/**/%original_file_name%",
-  },
-  {
-    #
-    # MDX documentation files - twenty-ui
-    # Using md type to preserve JSX component structure
-    #
-    "source": "packages/twenty-docs/twenty-ui/**/*.mdx",
-    "translation": "packages/twenty-docs/l/%two_letters_code%/twenty-ui/**/%original_file_name%",
-  },
-  {
-    #
-    # Navigation labels template - translated into per-locale navigation.json
-    #
-    "source": "packages/twenty-docs/navigation/navigation.template.json",
-    "translation": "packages/twenty-docs/l/%two_letters_code%/navigation.json",
-  }
-]
-

.github/dependabot.yml

@@ -1,17 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "npm"
-    directory: "/"
-    exclude-paths:
-      - "packages/twenty-apps/community/**"
-    schedule:
-      interval: "weekly"
-    open-pull-requests-limit: 3
-    versioning-strategy: "lockfile-only"
-    assignees:
-      - "mabdullahabaid"
-    ignore:
-      - dependency-name: "@graphql-yoga/nestjs"
-      - dependency-name: "@nestjs/graphql"
-      - dependency-name: "@ptc-org/nestjs-query-graphql"
-      - dependency-name: "typeorm"

.github/workflows/actions/nx-affected/action.yaml

@@ -0,0 +1,21 @@
+name: Nx Affected CI
+inputs:
+  parallel:
+    required: false
+    default: '3'
+  tag:
+    required: false
+  tasks:
+    required: true
+  configuration:
+    required: false
+    default: 'ci'
+
+runs:
+  using: "composite"
+  steps:
+    - name: Get last successful commit
+      uses: nrwl/nx-set-shas@v4
+    - name: Run affected command
+      shell: bash
+      run: npx nx affected --nxBail --configuration=${{ inputs.configuration }} -t=${{ inputs.tasks }} --parallel=${{ inputs.parallel }} --exclude='*,!tag:${{ inputs.tag }}'

.github/workflows/actions/restore-cache/action.yaml

@@ -0,0 +1,35 @@
+name: Restore cache
+inputs:
+  key:
+    required: true
+    description: Prefix to the cache key
+  additional-paths:
+    required: false
+outputs:
+  cache-primary-key:
+    description: actions/cache/restore cache-primary-key outputs proxy
+    value: ${{ steps.restore-cache.outputs.cache-primary-key }}
+  cache-hit:
+    description: String bool indicating whether cache has been directly or indirectly hit
+    value: ${{ steps.restore-cache.outputs.cache-hit == 'true' || steps.restore-cache.outputs.cache-matched-key != '' }}
+
+runs:
+  using: composite
+  steps:
+    - name: Cache primary key builder
+      id: cache-primary-key-builder
+      shell: bash
+      run: |
+        echo "CACHE_PRIMARY_KEY_PREFIX=${{ inputs.key }}-${{ github.ref_name }}" >> "${GITHUB_OUTPUT}"
+    - name: Restore cache
+      uses: actions/cache/restore@v4
+      id: restore-cache
+      with:
+        key:  ${{ steps.cache-primary-key-builder.outputs.CACHE_PRIMARY_KEY_PREFIX }}-${{ github.sha }}
+        restore-keys: ${{ steps.cache-primary-key-builder.outputs.CACHE_PRIMARY_KEY_PREFIX }}-
+        path: |
+          .cache
+          .nx/cache
+          node_modules/.cache
+          packages/*/node_modules/.cache
+          ${{ inputs.additional-paths }}

.github/workflows/actions/save-cache/action.yaml

@@ -0,0 +1,21 @@
+name: Save cache
+inputs:
+  key:
+    required: true
+    description: Primary key to the cache, should be retrieved from `cache-restore` composite action outputs.
+  additional-paths:
+    required: false
+
+runs:
+  using: "composite"
+  steps:
+    - name: Save cache
+      uses: actions/cache/save@v4
+      with:
+        key: ${{ inputs.key }}
+        path: |
+          .cache
+          .nx/cache
+          node_modules/.cache
+          packages/*/node_modules/.cache
+          ${{ inputs.additional-paths }}

.github/workflows/actions/yarn-install/action.yaml

@@ -0,0 +1,43 @@
+name: Yarn Install
+inputs:
+  node-version:
+    required: false
+    default: '18'
+
+runs:
+  using: "composite"
+  steps:
+    - name: Cache primary key builder
+      id: globals
+      shell: bash
+      run: |
+        echo "ACTION_SHELL=bash" >> "${GITHUB_OUTPUT}"
+        echo "CACHE_KEY_PREFIX=node_modules-cache-node-${{ inputs.node-version }}-${{ hashFiles('yarn.lock') }}"  >> "${GITHUB_OUTPUT}"
+        echo 'PATH_TO_CACHE<<EOF' >> $GITHUB_OUTPUT
+        echo "node_modules" >> $GITHUB_OUTPUT
+        echo "packages/*/node_modules" >> $GITHUB_OUTPUT
+        echo 'EOF' >> $GITHUB_OUTPUT
+    - name: Setup Node.js and get yarn cache
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+    - name: Restore node_modules
+      id: cache-node-modules
+      uses: actions/cache/restore@v4
+      with:
+        key: ${{ steps.globals.outputs.CACHE_KEY_PREFIX }}-${{github.sha}}
+        restore-keys: ${{ steps.globals.outputs.CACHE_KEY_PREFIX }}-
+        path: ${{ steps.globals.outputs.PATH_TO_CACHE }}
+    - name: Install Dependencies
+      if: ${{ steps.cache-node-modules.outputs.cache-hit != 'true' && steps.cache-node-modules.outputs.cache-matched-key == '' }}
+      shell: ${{ steps.globals.outputs.ACTION_SHELL }}
+      run: |
+        yarn config set enableHardenedMode true
+        yarn --immutable --check-cache
+    - name: Save cache
+      if: ${{ steps.cache-node-modules.outputs.cache-hit != 'true' && steps.cache-node-modules.outputs.cache-matched-key == '' }}
+      uses: actions/cache/save@v4
+      with:
+        key: ${{ steps.cache-node-modules.outputs.cache-primary-key }}
+        path: ${{ steps.globals.outputs.PATH_TO_CACHE }}
+      

.github/workflows/cd-deploy-main.yaml

@@ -1,13 +1,8 @@
 name: CD deploy main
-
-permissions:
-  contents: read
-
 on:
   push:
     branches:
       - main
-
 jobs:
   deploy-main:
     timeout-minutes: 3

.github/workflows/cd-deploy-tag.yaml

@@ -1,13 +1,8 @@
 name: CD deploy tag
-
-permissions:
-  contents: read
-
 on:
   push:
     tags:
       - 'v*'
-
 jobs:
   deploy-tag:
     timeout-minutes: 3

.github/workflows/changed-files.yaml

@@ -1,5 +1,4 @@
 name: Changed files reusable workflow
-
 on:
   workflow_call:
     inputs:
@@ -10,9 +9,6 @@ on:
       any_changed:
         value: ${{ jobs.changed-files.outputs.any_changed }}
 
-permissions:
-  contents: read
-
 jobs:
   changed-files:
     timeout-minutes: 5

.github/workflows/ci-breaking-changes.yaml

@@ -1,786 +0,0 @@
-name: GraphQL and OpenAPI Breaking Changes Detection
-
-on:
- pull_request:
-    types: [opened, synchronize, edited]
-    branches:
-      - main
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-env:
-  MAIN_SERVER_PORT: 3000
-  CURRENT_SERVER_PORT: 3002
-
-permissions:
-  contents: read
-  pull-requests: write
-  checks: write
-
-jobs:
-  changed-files-check:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        package.json
-        packages/twenty-server/**
-        packages/twenty-emails/**
-        packages/twenty-shared/**
-        .github/workflows/ci-breaking-changes.yaml
-
-  api-breaking-changes:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 45
-    runs-on: ubuntu-latest
-    services:
-      postgres:
-        image: twentycrm/twenty-postgres-spilo
-        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-      clickhouse:
-        image: clickhouse/clickhouse-server:25.8.8
-        env:
-          CLICKHOUSE_PASSWORD: clickhousePassword
-          CLICKHOUSE_URL: "http://default:clickhousePassword@localhost:8123/twenty"
-        ports:
-          - 8123:8123
-          - 9000:9000
-        options: >-
-          --health-cmd "clickhouse-client --host=localhost --port=9000 --user=default --password=clickhousePassword --query='SELECT 1'"
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-
-    steps:
-      - name: Checkout current branch
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Try to merge main into current branch
-        id: merge_attempt
-        run: |
-          echo "Attempting to merge main into current branch..."
-
-          git fetch origin main
-
-          CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
-          echo "Current branch: $CURRENT_BRANCH"
-
-          if git merge origin/main --no-edit; then
-            echo "✅ Successfully merged main into current branch"
-            echo "merged=true" >> $GITHUB_OUTPUT
-            echo "BRANCH_STATE=merged" >> $GITHUB_ENV
-          else
-            echo "❌ Merge failed due to conflicts"
-            echo "⚠️ Falling back to comparing current branch against main without merge"
-
-            # Abort the failed merge
-            git merge --abort
-
-            echo "merged=false" >> $GITHUB_OUTPUT
-            echo "BRANCH_STATE=conflicts" >> $GITHUB_ENV
-          fi
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Build shared dependencies
-        run: |
-          npx nx build twenty-shared
-          npx nx build twenty-emails
-
-      - name: Build current branch server
-        run: npx nx build twenty-server
-
-      - name: Setup databases
-        run: |
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "current_branch";'
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "main_branch";'
-
-      - name: Run ClickHouse migrations
-        run: npx nx clickhouse:migrate twenty-server
-        env:
-          CLICKHOUSE_URL: http://default:clickhousePassword@localhost:8123/twenty
-          CLICKHOUSE_PASSWORD: clickhousePassword
-
-      - name: Setup current branch database
-        run: |
-          npx nx reset:env twenty-server
-          set_env_var() {
-            local var_name="$1"
-            local var_value="$2"
-            local env_file="packages/twenty-server/.env"
-
-            echo "" >> "$env_file"
-
-            if grep -q "^${var_name}=" "$env_file" 2>/dev/null; then
-              sed -i "s|^${var_name}=.*|${var_name}=${var_value}|" "$env_file"
-            else
-              echo "${var_name}=${var_value}" >> "$env_file"
-            fi
-          }
-
-          set_env_var "PG_DATABASE_URL" "postgres://postgres:postgres@localhost:5432/current_branch"
-          set_env_var "NODE_PORT" "${{ env.CURRENT_SERVER_PORT }}"
-          set_env_var "REDIS_URL" "redis://localhost:6379"
-          set_env_var "CLICKHOUSE_URL" "http://default:clickhousePassword@localhost:8123/twenty"
-          set_env_var "CLICKHOUSE_PASSWORD" "clickhousePassword"
-
-          npx nx run twenty-server:database:init:prod
-          npx nx run twenty-server:database:migrate:prod
-
-      - name: Seed current branch database with test data
-        run: |
-          npx nx command-no-deps twenty-server -- workspace:seed:dev
-
-      - name: Start current branch server in background
-        run: |
-          echo "=== Current branch .env file contents ==="
-          cat packages/twenty-server/.env
-          echo "=== Starting current branch server ==="
-          nohup npx nx run twenty-server:start:prod > /tmp/current-server.log 2>&1 &
-          echo $! > /tmp/current-server.pid
-          echo "Current server PID: $(cat /tmp/current-server.pid)"
-
-      - name: Wait for current branch server to be ready
-        run: |
-          echo "Waiting for current branch server to start..."
-          timeout=300
-          interval=5
-          elapsed=0
-
-          while [ $elapsed -lt $timeout ]; do
-            if curl -s "http://localhost:${{ env.CURRENT_SERVER_PORT }}/graphql" > /dev/null 2>&1 && \
-               curl -s "http://localhost:${{ env.CURRENT_SERVER_PORT }}/rest/open-api/core" > /dev/null 2>&1; then
-              echo "Current branch server is ready!"
-              break
-            fi
-
-            echo "Current branch server not ready yet, waiting ${interval}s..."
-            sleep $interval
-            elapsed=$((elapsed + interval))
-          done
-
-          if [ $elapsed -ge $timeout ]; then
-            echo "Timeout waiting for current branch server to start"
-            echo "Current server log:"
-            cat /tmp/current-server.log || echo "No current server log found"
-            exit 1
-          fi
-
-      - name: Download GraphQL and REST responses from current branch
-        run: |
-          # Read admin token from shared test tokens file (single source of truth)
-          ADMIN_TOKEN=$(jq -r '.APPLE_JANE_ADMIN_ACCESS_TOKEN' packages/twenty-server/test/integration/constants/test-tokens.json)
-
-          # Load introspection query from file
-          INTROSPECTION_QUERY=$(cat packages/twenty-utils/graphql-introspection-query.graphql)
-
-          # Prepare the query payload
-          QUERY_PAYLOAD=$(echo "$INTROSPECTION_QUERY" | tr '\n' ' ' | sed 's/"/\\"/g')
-
-          echo "Downloading GraphQL schema from current server..."
-          curl -X POST "http://localhost:${{ env.CURRENT_SERVER_PORT }}/graphql" \
-            -H "Content-Type: application/json" \
-            -H "Authorization: Bearer ${ADMIN_TOKEN}" \
-            -d "{\"query\":\"${QUERY_PAYLOAD}\"}" \
-            -o current-schema-introspection.json \
-            -w "HTTP Status: %{http_code}\n" \
-            -s
-
-          echo "Downloading GraphQL metadata schema from current server..."
-          curl -X POST "http://localhost:${{ env.CURRENT_SERVER_PORT }}/metadata" \
-            -H "Content-Type: application/json" \
-            -H "Authorization: Bearer ${ADMIN_TOKEN}" \
-            -d "{\"query\":\"${QUERY_PAYLOAD}\"}" \
-            -o current-metadata-schema-introspection.json \
-            -w "HTTP Status: %{http_code}\n" \
-            -s
-
-          # Download current branch OpenAPI specs
-          echo "Downloading OpenAPI specifications from current server..."
-          curl -s "http://localhost:${{ env.CURRENT_SERVER_PORT }}/rest/open-api/core" \
-            -H "Authorization: Bearer ${ADMIN_TOKEN}" \
-            -o current-rest-api.json \
-            -w "HTTP Status: %{http_code}\n"
-
-          curl -s "http://localhost:${{ env.CURRENT_SERVER_PORT }}/rest/open-api/metadata" \
-            -H "Authorization: Bearer ${ADMIN_TOKEN}" \
-            -o current-rest-metadata-api.json \
-            -w "HTTP Status: %{http_code}\n"
-
-          # Verify the downloads
-          echo "Current branch files downloaded:"
-          ls -la current-*
-
-
-      - name: Preserve current branch files
-        run: |
-          # Create a temp directory to store current branch files
-          mkdir -p /tmp/current-branch-files
-
-          # Move current branch files to temp directory
-          mv current-* /tmp/current-branch-files/ 2>/dev/null || echo "No current-* files to preserve"
-
-          echo "Preserved current branch files for later restoration"
-
-      - name: Stop current branch server
-        run: |
-          if [ -f /tmp/current-server.pid ]; then
-            echo "Stopping current branch server..."
-            kill $(cat /tmp/current-server.pid) || true
-            # Wait a bit for graceful shutdown
-            sleep 5
-            # Force kill if still running
-            kill -9 $(cat /tmp/current-server.pid) 2>/dev/null || true
-            rm -f /tmp/current-server.pid
-          fi
-
-      - name: Checkout main branch
-        run: |
-          git stash
-          git checkout origin/main
-          git reset --hard
-          git clean -xfd -ff
-          rm -rf node_modules packages/*/node_modules packages/*/dist dist .nx/cache
-
-      - name: Install dependencies for main branch
-        uses: ./.github/actions/yarn-install
-
-      - name: Build main branch dependencies
-        run: |
-          npx nx reset
-          npx nx build twenty-shared
-          npx nx build twenty-emails
-
-      - name: Build main branch server
-        run: npx nx build twenty-server
-
-      - name: Setup main branch database
-        run: |
-          npx nx reset:env twenty-server
-          set_env_var() {
-            local var_name="$1"
-            local var_value="$2"
-            local env_file="packages/twenty-server/.env"
-
-            echo "" >> "$env_file"
-
-            if grep -q "^${var_name}=" "$env_file" 2>/dev/null; then
-              sed -i "s|^${var_name}=.*|${var_name}=${var_value}|" "$env_file"
-            else
-              echo "${var_name}=${var_value}" >> "$env_file"
-            fi
-          }
-
-          set_env_var "PG_DATABASE_URL" "postgres://postgres:postgres@localhost:5432/main_branch"
-          set_env_var "NODE_PORT" "${{ env.MAIN_SERVER_PORT }}"
-          set_env_var "REDIS_URL" "redis://localhost:6379"
-          set_env_var "CLICKHOUSE_URL" "http://default:clickhousePassword@localhost:8123/twenty"
-          set_env_var "CLICKHOUSE_PASSWORD" "clickhousePassword"
-
-          npx nx run twenty-server:database:init:prod
-          npx nx run twenty-server:database:migrate:prod
-
-      - name: Seed main branch database with test data
-        run: |
-          npx nx command-no-deps twenty-server -- workspace:seed:dev
-
-      - name: Start main branch server in background
-        run: |
-          echo "=== Main branch .env file contents ==="
-          cat packages/twenty-server/.env
-          echo "=== Starting main branch server ==="
-          nohup npx nx run twenty-server:start:prod > /tmp/main-server.log 2>&1 &
-          echo $! > /tmp/main-server.pid
-          echo "Main server PID: $(cat /tmp/main-server.pid)"
-
-      - name: Wait for main branch server to be ready
-        run: |
-          echo "Waiting for main branch server to start..."
-          timeout=300
-          interval=5
-          elapsed=0
-
-          while [ $elapsed -lt $timeout ]; do
-            if curl -s "http://localhost:${{ env.MAIN_SERVER_PORT }}/graphql" > /dev/null 2>&1 && \
-               curl -s "http://localhost:${{ env.MAIN_SERVER_PORT }}/rest/open-api/core" > /dev/null 2>&1; then
-              echo "Main branch server is ready!"
-              break
-            fi
-
-            echo "Main branch server not ready yet, waiting ${interval}s..."
-            sleep $interval
-            elapsed=$((elapsed + interval))
-          done
-
-          if [ $elapsed -ge $timeout ]; then
-            echo "Timeout waiting for main branch server to start"
-            echo "Main server log:"
-            cat /tmp/main-server.log || echo "No main server log found"
-            exit 1
-          fi
-
-      - name: Download GraphQL and REST responses from main branch
-        run: |
-          # Read admin token from shared test tokens file (single source of truth)
-          ADMIN_TOKEN=$(jq -r '.APPLE_JANE_ADMIN_ACCESS_TOKEN' packages/twenty-server/test/integration/constants/test-tokens.json)
-
-          # Load introspection query from file
-          INTROSPECTION_QUERY=$(cat packages/twenty-utils/graphql-introspection-query.graphql)
-
-          # Prepare the query payload
-          QUERY_PAYLOAD=$(echo "$INTROSPECTION_QUERY" | tr '\n' ' ' | sed 's/"/\\"/g')
-
-          echo "Downloading GraphQL schema from main server..."
-          curl -X POST "http://localhost:${{ env.MAIN_SERVER_PORT }}/graphql" \
-            -H "Content-Type: application/json" \
-            -H "Authorization: Bearer ${ADMIN_TOKEN}" \
-            -d "{\"query\":\"${QUERY_PAYLOAD}\"}" \
-            -o main-schema-introspection.json \
-            -w "HTTP Status: %{http_code}\n" \
-            -s
-
-          echo "Downloading GraphQL metadata schema from main server..."
-          curl -X POST "http://localhost:${{ env.MAIN_SERVER_PORT }}/metadata" \
-            -H "Content-Type: application/json" \
-            -H "Authorization: Bearer ${ADMIN_TOKEN}" \
-            -d "{\"query\":\"${QUERY_PAYLOAD}\"}" \
-            -o main-metadata-schema-introspection.json \
-            -w "HTTP Status: %{http_code}\n" \
-            -s
-
-          # Download main branch OpenAPI specs
-          echo "Downloading OpenAPI specifications from main server..."
-          curl -s "http://localhost:${{ env.MAIN_SERVER_PORT }}/rest/open-api/core" \
-            -H "Authorization: Bearer ${ADMIN_TOKEN}" \
-            -o main-rest-api.json \
-            -w "HTTP Status: %{http_code}\n"
-
-          curl -s "http://localhost:${{ env.MAIN_SERVER_PORT }}/rest/open-api/metadata" \
-            -H "Authorization: Bearer ${ADMIN_TOKEN}" \
-            -o main-rest-metadata-api.json \
-            -w "HTTP Status: %{http_code}\n"
-
-          # Verify the downloads
-          echo "Main branch files downloaded:"
-          ls -la main-*
-
-
-      - name: Restore current branch files
-        run: |
-          # Move current branch files back to working directory
-          mv /tmp/current-branch-files/* . 2>/dev/null || echo "No files to restore"
-
-          # Verify all files are present
-          echo "All API files restored:"
-          ls -la current-* main-* 2>/dev/null || echo "Some files may be missing"
-
-          # Clean up temp directory
-          rm -rf /tmp/current-branch-files
-
-      - name: Install OpenAPI Diff Tool
-        run: |
-          # Using the Java-based OpenAPITools/openapi-diff via Docker
-          echo "Using OpenAPITools/openapi-diff via Docker"
-
-      - name: Generate GraphQL Schema Diff Reports
-        run: |
-          echo "=== INSTALLING GRAPHQL INSPECTOR CLI ==="
-          npm install -g @graphql-inspector/cli
-
-          echo "=== GENERATING GRAPHQL DIFF REPORTS ==="
-
-          # Check if GraphQL schema has changes
-          echo "Checking GraphQL schema for changes..."
-          if graphql-inspector diff main-schema-introspection.json current-schema-introspection.json >/dev/null 2>&1; then
-            echo "✅ No changes in GraphQL schema"
-            # Don't create a diff file for no changes
-          else
-            echo "⚠️ Changes detected in GraphQL schema, generating report..."
-            echo "# GraphQL Schema Changes" > graphql-schema-diff.md
-            echo "" >> graphql-schema-diff.md
-            graphql-inspector diff main-schema-introspection.json current-schema-introspection.json >> graphql-schema-diff.md 2>&1 || {
-              echo "⚠️ **Breaking changes or errors detected in GraphQL schema**" >> graphql-schema-diff.md
-              echo "" >> graphql-schema-diff.md
-              echo "\`\`\`" >> graphql-schema-diff.md
-              graphql-inspector diff main-schema-introspection.json current-schema-introspection.json 2>&1 >> graphql-schema-diff.md || echo "Error generating diff" >> graphql-schema-diff.md
-              echo "\`\`\`" >> graphql-schema-diff.md
-            }
-          fi
-
-          # Check if GraphQL metadata schema has changes
-          echo "Checking GraphQL metadata schema for changes..."
-          if graphql-inspector diff main-metadata-schema-introspection.json current-metadata-schema-introspection.json >/dev/null 2>&1; then
-            echo "✅ No changes in GraphQL metadata schema"
-            # Don't create a diff file for no changes
-          else
-            echo "⚠️ Changes detected in GraphQL metadata schema, generating report..."
-            echo "# GraphQL Metadata Schema Changes" > graphql-metadata-diff.md
-            echo "" >> graphql-metadata-diff.md
-            graphql-inspector diff main-metadata-schema-introspection.json current-metadata-schema-introspection.json >> graphql-metadata-diff.md 2>&1 || {
-              echo "⚠️ **Breaking changes or errors detected in GraphQL metadata schema**" >> graphql-metadata-diff.md
-              echo "" >> graphql-metadata-diff.md
-              echo "\`\`\`" >> graphql-metadata-diff.md
-              graphql-inspector diff main-metadata-schema-introspection.json current-metadata-schema-introspection.json 2>&1 >> graphql-metadata-diff.md || echo "Error generating diff" >> graphql-metadata-diff.md
-              echo "\`\`\`" >> graphql-metadata-diff.md
-            }
-          fi
-
-          # Show summary
-          echo "Generated diff files:"
-          ls -la *-diff.md 2>/dev/null || echo "No diff files generated (no changes detected)"
-
-      - name: Check REST API Breaking Changes
-        run: |
-          echo "=== CHECKING REST API FOR BREAKING CHANGES ==="
-
-          # Use the Java-based openapi-diff via Docker
-          docker run --rm -v "$(pwd):/specs" openapitools/openapi-diff:latest \
-            --json /specs/rest-api-diff.json \
-            /specs/main-rest-api.json /specs/current-rest-api.json || echo "OpenAPI diff completed with exit code $?"
-
-          # Check if the output file was created and is valid JSON
-          if [ -f "rest-api-diff.json" ] && jq empty rest-api-diff.json 2>/dev/null; then
-            # Check for breaking changes using Java openapi-diff JSON structure
-            incompatible=$(jq -r '.incompatible // false' rest-api-diff.json)
-            different=$(jq -r '.different // false' rest-api-diff.json)
-
-            # Count changes
-            new_endpoints=$(jq -r '.newEndpoints | length' rest-api-diff.json 2>/dev/null || echo "0")
-            missing_endpoints=$(jq -r '.missingEndpoints | length' rest-api-diff.json 2>/dev/null || echo "0")
-            changed_operations=$(jq -r '.changedOperations | length' rest-api-diff.json 2>/dev/null || echo "0")
-
-            if [ "$incompatible" = "true" ]; then
-              echo "❌ Breaking changes detected in REST API"
-
-              # Generate breaking changes report
-              echo "# REST API Breaking Changes" > rest-api-diff.md
-              echo "" >> rest-api-diff.md
-              echo "⚠️ **Breaking changes detected that may affect existing API consumers**" >> rest-api-diff.md
-              echo "" >> rest-api-diff.md
-
-              # Parse and format the changes from Java openapi-diff
-              jq -r '
-                if (.missingEndpoints | length) > 0 then
-                  "## 🚨 Removed Endpoints (" + (.missingEndpoints | length | tostring) + ")\n" +
-                  (.missingEndpoints | map("- **" + .method + " " + .pathUrl + "**: " + (.summary // "")) | join("\n"))
-                else "" end,
-                if (.changedOperations | length) > 0 then
-                  "\n## ⚠️ Changed Operations (" + (.changedOperations | length | tostring) + ")\n" +
-                  (.changedOperations | map("- **" + .method + " " + .pathUrl + "**: " + (.summary // "Modified operation")) | join("\n"))
-                else "" end,
-                if (.newEndpoints | length) > 0 then
-                  "\n## ✅ New Endpoints (" + (.newEndpoints | length | tostring) + ")\n" +
-                  (.newEndpoints | map("- " + .method + " " + .pathUrl + ": " + (.summary // "")) | join("\n"))
-                else "" end
-              ' rest-api-diff.json >> rest-api-diff.md
-
-            elif [ "$different" = "true" ]; then
-              echo "📝 Non-breaking changes detected ($new_endpoints new endpoints, $missing_endpoints removed, $changed_operations changed) - no PR comment will be posted"
-              # Don't create markdown file for non-breaking changes to avoid PR comments
-            else
-              echo "✅ No changes detected in REST API"
-              # Don't create diff file for no changes
-            fi
-          else
-            echo "⚠️ OpenAPI diff tool could not process the files"
-
-            echo "# REST API Analysis Error" > rest-api-diff.md
-            echo "" >> rest-api-diff.md
-            echo "⚠️ **Error occurred while analyzing REST API changes**" >> rest-api-diff.md
-            echo "" >> rest-api-diff.md
-            echo "## Error Output" >> rest-api-diff.md
-            echo "\`\`\`" >> rest-api-diff.md
-            docker run --rm -v "$(pwd):/specs" openapitools/openapi-diff:latest /specs/main-rest-api.json /specs/current-rest-api.json 2>&1 >> rest-api-diff.md || echo "Could not capture error output"
-            echo "\`\`\`" >> rest-api-diff.md
-
-            # Don't fail the workflow for tool errors
-            echo "::warning::REST API analysis tool error - continuing workflow"
-          fi
-
-      - name: Check REST Metadata API Breaking Changes
-        run: |
-          echo "=== CHECKING REST METADATA API FOR BREAKING CHANGES ==="
-
-          # Use the Java-based openapi-diff for metadata API as well
-          docker run --rm -v "$(pwd):/specs" openapitools/openapi-diff:latest \
-            --json /specs/rest-metadata-api-diff.json \
-            /specs/main-rest-metadata-api.json /specs/current-rest-metadata-api.json || echo "OpenAPI diff completed with exit code $?"
-
-          # Check if the output file was created and is valid JSON
-          if [ -f "rest-metadata-api-diff.json" ] && jq empty rest-metadata-api-diff.json 2>/dev/null; then
-            # Check for breaking changes using Java openapi-diff JSON structure
-            incompatible=$(jq -r '.incompatible // false' rest-metadata-api-diff.json)
-            different=$(jq -r '.different // false' rest-metadata-api-diff.json)
-
-            # Count changes
-            new_endpoints=$(jq -r '.newEndpoints | length' rest-metadata-api-diff.json 2>/dev/null || echo "0")
-            missing_endpoints=$(jq -r '.missingEndpoints | length' rest-metadata-api-diff.json 2>/dev/null || echo "0")
-            changed_operations=$(jq -r '.changedOperations | length' rest-metadata-api-diff.json 2>/dev/null || echo "0")
-
-            if [ "$incompatible" = "true" ]; then
-              echo "❌ Breaking changes detected in REST Metadata API"
-
-              # Generate breaking changes report (only for breaking changes)
-              echo "# REST Metadata API Breaking Changes" > rest-metadata-api-diff.md
-              echo "" >> rest-metadata-api-diff.md
-              echo "⚠️ **Breaking changes detected that may affect existing API consumers**" >> rest-metadata-api-diff.md
-              echo "" >> rest-metadata-api-diff.md
-
-              # Parse and format the changes from Java openapi-diff
-              jq -r '
-                if (.missingEndpoints | length) > 0 then
-                  "## 🚨 Removed Endpoints (" + (.missingEndpoints | length | tostring) + ")\n" +
-                  (.missingEndpoints | map("- **" + .method + " " + .pathUrl + "**: " + (.summary // "")) | join("\n"))
-                else "" end,
-                if (.changedOperations | length) > 0 then
-                  "\n## ⚠️ Changed Operations (" + (.changedOperations | length | tostring) + ")\n" +
-                  (.changedOperations | map("- **" + .method + " " + .pathUrl + "**: " + (.summary // "Modified operation")) | join("\n"))
-                else "" end,
-                if (.newEndpoints | length) > 0 then
-                  "\n## ✅ New Endpoints (" + (.newEndpoints | length | tostring) + ")\n" +
-                  (.newEndpoints | map("- " + .method + " " + .pathUrl + ": " + (.summary // "")) | join("\n"))
-                else "" end
-              ' rest-metadata-api-diff.json >> rest-metadata-api-diff.md
-
-            elif [ "$different" = "true" ]; then
-              echo "📝 Non-breaking changes detected ($new_endpoints new endpoints, $missing_endpoints removed, $changed_operations changed) - no PR comment will be posted"
-              # Don't create markdown file for non-breaking changes to avoid PR comments
-            else
-              echo "✅ No changes detected in REST Metadata API"
-            fi
-          else
-            echo "⚠️ OpenAPI diff tool could not process the metadata API files"
-
-            echo "# REST Metadata API Analysis Error" > rest-metadata-api-diff.md
-            echo "" >> rest-metadata-api-diff.md
-            echo "⚠️ **Error occurred while analyzing REST Metadata API changes**" >> rest-metadata-api-diff.md
-            echo "" >> rest-metadata-api-diff.md
-            echo "## Error Output" >> rest-metadata-api-diff.md
-            echo "\`\`\`" >> rest-metadata-api-diff.md
-            docker run --rm -v "$(pwd):/specs" openapitools/openapi-diff:latest /specs/main-rest-metadata-api.json /specs/current-rest-metadata-api.json 2>&1 >> rest-metadata-api-diff.md || echo "Could not capture error output"
-            echo "\`\`\`" >> rest-metadata-api-diff.md
-
-            # Don't fail the workflow for tool errors
-            echo "::warning::REST Metadata API analysis tool error - continuing workflow"
-          fi
-
-      - name: Comment API Changes on PR
-        if: always()
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const fs = require('fs');
-            let hasChanges = false;
-            let comment = '';
-
-            try {
-              if (fs.existsSync('graphql-schema-diff.md')) {
-                const graphqlDiff = fs.readFileSync('graphql-schema-diff.md', 'utf8');
-                if (graphqlDiff.trim()) {
-                  if (!hasChanges) {
-                    comment = '## 📊 API Changes Report\n\n';
-                    hasChanges = true;
-                  }
-                  comment += '### GraphQL Schema Changes\n' + graphqlDiff + '\n\n';
-                }
-              }
-
-              if (fs.existsSync('graphql-metadata-diff.md')) {
-                const graphqlMetadataDiff = fs.readFileSync('graphql-metadata-diff.md', 'utf8');
-                if (graphqlMetadataDiff.trim()) {
-                  if (!hasChanges) {
-                    comment = '## 📊 API Changes Report\n\n';
-                    hasChanges = true;
-                  }
-                  comment += '### GraphQL Metadata Schema Changes\n' + graphqlMetadataDiff + '\n\n';
-                }
-              }
-
-              if (fs.existsSync('rest-api-diff.md')) {
-                const restDiff = fs.readFileSync('rest-api-diff.md', 'utf8');
-                if (restDiff.trim()) {
-                  if (!hasChanges) {
-                    comment = '## 📊 API Changes Report\n\n';
-                    hasChanges = true;
-                  }
-                  comment += restDiff + '\n\n';
-                }
-              }
-
-              if (fs.existsSync('rest-metadata-api-diff.md')) {
-                const metadataDiff = fs.readFileSync('rest-metadata-api-diff.md', 'utf8');
-                if (metadataDiff.trim()) {
-                  if (!hasChanges) {
-                    comment = '## 📊 API Changes Report\n\n';
-                    hasChanges = true;
-                  }
-                  comment += metadataDiff + '\n\n';
-                }
-              }
-
-              // Only post comment if there are changes
-              if (hasChanges) {
-                // Add branch state information only if there were conflicts
-                const branchState = process.env.BRANCH_STATE || 'unknown';
-                let branchStateNote = '';
-
-                if (branchState === 'conflicts') {
-                  branchStateNote = '\n\n⚠️ **Note**: Could not merge with `main` due to conflicts. This comparison shows changes between the current branch and `main` as separate states.\n';
-                }
-                // Check if there are any breaking changes detected
-                let hasBreakingChanges = false;
-                let breakingChangeNote = '';
-
-                // Check for breaking changes in any of the diff files
-                if (fs.existsSync('rest-api-diff.md')) {
-                  const restDiff = fs.readFileSync('rest-api-diff.md', 'utf8');
-                  if (restDiff.includes('Breaking Changes') || restDiff.includes('🚨') ||
-                      restDiff.includes('Removed Endpoints') || restDiff.includes('Changed Operations')) {
-                    hasBreakingChanges = true;
-                  }
-                }
-
-                if (fs.existsSync('rest-metadata-api-diff.md')) {
-                  const metadataDiff = fs.readFileSync('rest-metadata-api-diff.md', 'utf8');
-                  if (metadataDiff.includes('Breaking Changes') || metadataDiff.includes('🚨') ||
-                      metadataDiff.includes('Removed Endpoints') || metadataDiff.includes('Changed Operations')) {
-                    hasBreakingChanges = true;
-                  }
-                }
-
-                // Also check GraphQL changes for breaking changes indicators
-                if (fs.existsSync('graphql-schema-diff.md')) {
-                  const graphqlDiff = fs.readFileSync('graphql-schema-diff.md', 'utf8');
-                  if (graphqlDiff.includes('Breaking changes') || graphqlDiff.includes('BREAKING')) {
-                    hasBreakingChanges = true;
-                  }
-                }
-
-                if (fs.existsSync('graphql-metadata-diff.md')) {
-                  const graphqlMetadataDiff = fs.readFileSync('graphql-metadata-diff.md', 'utf8');
-                  if (graphqlMetadataDiff.includes('Breaking changes') || graphqlMetadataDiff.includes('BREAKING')) {
-                    hasBreakingChanges = true;
-                  }
-                }
-
-                // Check PR title for "breaking"
-                const prTitle = ${{ toJSON(github.event.pull_request.title) }};
-                const titleContainsBreaking = prTitle.toLowerCase().includes('breaking');
-
-                if (hasBreakingChanges) {
-                  if (titleContainsBreaking) {
-                    breakingChangeNote = '\n\n## ✅ Breaking Change Protocol\n\n' +
-                      '**This PR title contains "breaking" and breaking changes were detected - the CI will fail as expected.**\n\n' +
-                      '📝 **Action Required**: Please add `BREAKING CHANGE:` to your commit message to trigger a major version bump.\n\n' +
-                      'Example:\n```\nfeat: add new API endpoint\n\nBREAKING CHANGE: removed deprecated field from User schema\n```';
-                  } else {
-                    breakingChangeNote = '\n\n## ⚠️ Breaking Change Protocol\n\n' +
-                      '**Breaking changes detected but PR title does not contain "breaking" - CI will pass but action needed.**\n\n' +
-                      '🔄 **Options**:\n' +
-                      '1. **If this IS a breaking change**: Add "breaking" to your PR title and add `BREAKING CHANGE:` to your commit message\n' +
-                      '2. **If this is NOT a breaking change**: The API diff tool may have false positives - please review carefully\n\n' +
-                      'For breaking changes, add to commit message:\n```\nfeat: add new API endpoint\n\nBREAKING CHANGE: removed deprecated field from User schema\n```';
-                  }
-                }
-
-                const COMMENT_MARKER = '<!-- API_CHANGES_REPORT -->';
-                const commentBody = COMMENT_MARKER + '\n' + comment + branchStateNote + '\n⚠️ **Please review these API changes carefully before merging.**' + breakingChangeNote;
-
-                // Get all comments to find existing API changes comment
-                const {data: comments} = await github.rest.issues.listComments({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: context.issue.number,
-                });
-
-                // Find our existing comment
-                const botComment = comments.find(comment => comment.body.includes(COMMENT_MARKER));
-
-                if (botComment) {
-                  // Update existing comment
-                  await github.rest.issues.updateComment({
-                    owner: context.repo.owner,
-                    repo: context.repo.repo,
-                    comment_id: botComment.id,
-                    body: commentBody
-                  });
-                  console.log('Updated existing API changes comment');
-                } else {
-                  // Create new comment
-                  await github.rest.issues.createComment({
-                    issue_number: context.issue.number,
-                    owner: context.repo.owner,
-                    repo: context.repo.repo,
-                    body: commentBody
-                  });
-                  console.log('Created new API changes comment');
-                }
-              } else {
-                console.log('No API changes detected - skipping PR comment');
-
-                // Check if there's an existing comment to remove
-                const {data: comments} = await github.rest.issues.listComments({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: context.issue.number,
-                });
-
-                const COMMENT_MARKER = '<!-- API_CHANGES_REPORT -->';
-                const botComment = comments.find(comment => comment.body.includes(COMMENT_MARKER));
-
-                if (botComment) {
-                  await github.rest.issues.deleteComment({
-                    owner: context.repo.owner,
-                    repo: context.repo.repo,
-                    comment_id: botComment.id,
-                  });
-                  console.log('Deleted existing API changes comment (no changes detected)');
-                }
-              }
-            } catch (error) {
-              console.log('Could not post comment:', error);
-            }
-
-      - name: Cleanup servers
-        if: always()
-        run: |
-          if [ -f /tmp/current-server.pid ]; then
-            kill $(cat /tmp/current-server.pid) || true
-          fi
-          if [ -f /tmp/main-server.pid ]; then
-            kill $(cat /tmp/main-server.pid) || true
-          fi
-
-      - name: Upload API specifications and diffs
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: api-specifications-and-diffs
-          path: |
-            /tmp/main-server.log
-            /tmp/current-server.log
-            *-api.json
-            *-schema-introspection.json
-            *-diff.md
-            *-diff.json
-

.github/workflows/ci-chrome-extension.yaml

@@ -0,0 +1,48 @@
+name: CI Chrome Extension
+on:
+  push:
+    branches:
+      - main
+
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  changed-files-check:
+    uses: ./.github/workflows/changed-files.yaml
+    with:
+      files: |
+        package.json
+        packages/twenty-chrome-extension/**
+  chrome-extension-build:
+    needs: changed-files-check
+    if: needs.changed-files-check.outputs.any_changed == 'true'
+    timeout-minutes: 15
+    runs-on: ubuntu-latest
+    env:
+      VITE_SERVER_BASE_URL: http://localhost:3000
+      VITE_FRONT_BASE_URL: http://localhost:3001
+    steps:
+      - name: Cancel Previous Runs
+        uses: styfle/cancel-workflow-action@0.11.0
+        with:
+          access_token: ${{ github.token }}
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install dependencies
+        uses: ./.github/workflows/actions/yarn-install
+      - name: Chrome Extension / Run build
+        run: npx nx build twenty-chrome-extension
+  ci-chrome-extension-status-check:
+    if: always() && !cancelled()
+    timeout-minutes: 1
+    runs-on: ubuntu-latest
+    needs: [changed-files-check, chrome-extension-build]
+    steps:
+      - name: Fail job if any needs failed
+        if: contains(needs.*.result, 'failure')
+        run: exit 1

.github/workflows/ci-create-app.yaml

@@ -1,57 +0,0 @@
-name: CI Create App
-
-on:
-  push:
-    branches:
-      - main
-
-  pull_request:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  changed-files-check:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        packages/create-twenty-app/**
-  create-app-test:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 30
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        task: [lint, typecheck, test]
-    steps:
-      - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.11.0
-        with:
-          access_token: ${{ github.token }}
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build
-        run: npx nx build create-twenty-app
-      - name: Run ${{ matrix.task }} task
-        uses: ./.github/actions/nx-affected
-        with:
-          tag: scope:create-app
-          tasks: ${{ matrix.task }}
-  ci-create-app-status-check:
-    if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
-    needs: [changed-files-check, create-app-test]
-    steps:
-      - name: Fail job if any needs failed
-        if: contains(needs.*.result, 'failure')
-        run: exit 1

.github/workflows/ci-demo-check.yml

@@ -0,0 +1,63 @@
+name: CI Demo check
+on:
+  schedule:
+    - cron: '30 7,19 * * *'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    timeout-minutes: 15
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./packages/twenty-e2e-testing
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+
+      - name: Install dependencies
+        uses: ./.github/workflows/actions/yarn-install
+
+      - name: Install Playwright Browsers
+        run: yarn playwright install --with-deps
+
+      - name: Run Playwright tests
+        id: test
+        run: yarn playwright test --grep "@demo-only"
+
+      - name: Upload report after tests
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 90
+
+      - name: Send Discord notification
+        env:
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
+        uses: Ilshidur/action-discord@0.3.2
+        with:
+          args: 'Demo check ${{ steps.test.outcome }} - check ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}'
+
+      - name: Send email if demo is not working
+        if: steps.test.outcome == 'failure'
+        uses: dawidd6/action-send-mail@v3.12.0
+        with:
+          connection_url: ${{ secrets.MAIL_CONNECTION }}
+          server_address: smtp.gmail.com
+          server_port: 465
+          secure: true
+          username: ${{ secrets.MAIL_USERNAME }}
+          subject: 'Demo is not working'
+          from: 'Github CI Demo check'
+          to: ${{ secrets.RECIPIENTS }}
+          body: '<a href="${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}">Link</a>'
+          priority: high

.github/workflows/ci-docs.yaml

@@ -1,47 +0,0 @@
-name: CI Docs
-
-on:
-  push:
-    branches:
-      - main
-
-  pull_request:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  changed-files-check:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        package.json
-        packages/twenty-docs/**
-        eslint.config.mjs
-
-  docs-lint:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 10
-    runs-on: ubuntu-latest
-    steps:
-      - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.11.0
-        with:
-          access_token: ${{ github.token }}
-
-      - name: Fetch local actions
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Docs / Lint English MDX files
-        run: npx eslint "packages/twenty-docs/{developers,user-guide,twenty-ui,getting-started,snippets}/**/*.mdx" --max-warnings 0
-

.github/workflows/ci-e2e.yaml

@@ -0,0 +1,133 @@
+name: CI E2E Playwright Tests
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types: [opened, synchronize, reopened, labeled]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  changed-files-check:
+    uses: ./.github/workflows/changed-files.yaml
+    with:
+      files: |
+          packages/**
+          playwright.config.ts
+          .github/workflows/ci-e2e.yaml
+  test:
+    runs-on: ubuntu-latest
+    needs: changed-files-check
+    if: needs.changed-files-check.outputs.any_changed == 'true' && ( github.event_name == 'push' || (github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, 'run-e2e')))
+    timeout-minutes: 30
+    env:
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
+      # https://github.com/actions/runner-images/issues/70#issuecomment-589562148
+      NODE_OPTIONS: "--max-old-space-size=10240"
+    services:
+      postgres:
+        image: twentycrm/twenty-postgres-spilo
+        env:
+          PGUSER_SUPERUSER: postgres
+          PGPASSWORD_SUPERUSER: postgres
+          ALLOW_NOSSL: "true"
+          SPILO_PROVIDER: "local"
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+      redis:
+        image: redis
+        ports:
+          - 6379:6379
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    - uses: actions/setup-node@v4
+      with:
+        node-version: lts/*
+
+    - name: Check system resources
+      run: |
+        echo "Available memory:"
+        free -h
+        echo "Available disk space:"
+        df -h
+        echo "CPU info:"
+        lscpu
+
+    - name: Install dependencies
+      uses: ./.github/workflows/actions/yarn-install
+
+    - name: Build twenty-shared
+      run: npx nx build twenty-shared
+
+    - name: Install Playwright Browsers
+      run: npx nx setup twenty-e2e-testing
+
+    - name: Setup environment files
+      run: |
+        cp packages/twenty-front/.env.example packages/twenty-front/.env
+        npx nx reset:env twenty-server
+
+    - name: Build frontend
+      run: NODE_ENV=production NODE_OPTIONS="--max-old-space-size=10240" npx nx build twenty-front
+
+    - name: Build server
+      run: npx nx build twenty-server
+
+    - name: Create and setup database
+      run: |
+        PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
+        PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
+        npx nx run twenty-server:database:reset
+
+    - name: Start server
+      run: |
+        npx nx start twenty-server &
+        echo "Waiting for server to be ready..."
+        timeout 60 bash -c 'until curl -s http://localhost:3000/health; do sleep 2; done'
+
+    - name: Start frontend
+      run: |
+        npm_config_yes=true npx serve -s packages/twenty-front/build -l 3001 &
+        echo "Waiting for frontend to be ready..."
+        timeout 60 bash -c 'until curl -s http://localhost:3001; do sleep 2; done'
+        
+    - name: Start worker
+      run: |
+        npx nx run twenty-server:worker &
+        echo "Worker started"
+
+    - name: Run Playwright tests
+      run: npx nx test twenty-e2e-testing
+
+    - uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: playwright-report
+        path: packages/twenty-e2e-testing/run_results/
+        retention-days: 30
+
+    - uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: playwright-report
+        path: packages/twenty-e2e-testing/playwright-report/
+        retention-days: 30
+  ci-e2e-status-check:
+      if: always() && !cancelled()
+      timeout-minutes: 1
+      runs-on: ubuntu-latest
+      needs: [changed-files-check, test]
+      steps:
+        - name: Fail job if any needs failed
+          if: contains(needs.*.result, 'failure')
+          run: exit 1

.github/workflows/ci-emails.yaml

@@ -1,64 +0,0 @@
-name: CI Emails
-
-permissions:
-  contents: read
-
-on:
-  push:
-    branches:
-      - main
-
-  pull_request:
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  changed-files-check:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        package.json
-        packages/twenty-emails/**
-  emails-test:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 10
-    runs-on: ubuntu-latest-8-cores
-    steps:
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build twenty-emails
-        run: npx nx build twenty-emails
-      - name: Run email tests
-        run: |
-          # Start the email server in the background
-          npx nx run twenty-emails:start &
-          SERVER_PID=$!
-
-          # Wait for server to start
-          sleep 20
-
-          # Check if server is running
-          if ! curl -s http://localhost:4001/preview/test.email > /dev/null; then
-            echo "Email server failed to start"
-            kill $SERVER_PID
-            exit 1
-          fi
-
-          # Kill the server
-          kill $SERVER_PID
-  ci-emails-status-check:
-    if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
-    needs: [changed-files-check, emails-test]
-    steps:
-      - name: Fail job if any needs failed
-        if: contains(needs.*.result, 'failure')
-        run: exit 1

.github/workflows/ci-front.yaml

@@ -1,21 +1,17 @@
-name: CI Front and E2E
-
+name: CI Front
 on:
+  push:
+    branches:
+      - main
+
   pull_request:
 
-  merge_group:
-
-permissions:
-  contents: read
-
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+  cancel-in-progress: true
 
 env:
-  # restore-cache action adds 'v4-' prefix and '-<branch>-<sha>' suffix to the key
-  STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION: storybook-build-ubuntu-latest-8-cores-runner
-  STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION: v4-storybook-build-ubuntu-latest-8-cores-runner-${{ github.ref_name }}-${{ github.sha }}
+  STORYBOOK_BUILD_CACHE_KEY: storybook-build-depot-ubuntu-24.04-8-runner
 
 jobs:
   changed-files-check:
@@ -23,25 +19,17 @@ jobs:
     with:
       files: |
         package.json
-        yarn.lock
         packages/twenty-front/**
         packages/twenty-ui/**
         packages/twenty-shared/**
-        packages/twenty-sdk/**
-  changed-files-check-e2e:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        packages/**
-        playwright.config.ts
-        .github/workflows/ci-front.yaml
   front-sb-build:
-    needs: changed-files-check
+    needs: [changed-files-check]
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     env:
       REACT_APP_SERVER_BASE_URL: http://localhost:3000
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
     steps:
       - name: Cancel Previous Runs
         uses: styfle/cancel-workflow-action@0.11.0
@@ -52,20 +40,25 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - name: Diagnostic disk space issue
         run: df -h
+      - name: Restore storybook build cache
+        id: restore-storybook-build-cache
+        uses: ./.github/workflows/actions/restore-cache
+        with:
+          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY }}
       - name: Front / Write .env
         run: npx nx reset:env twenty-front
       - name: Front / Build storybook
         run: npx nx storybook:build twenty-front
       - name: Save storybook build cache
-        uses: ./.github/actions/save-cache
+        uses: ./.github/workflows/actions/save-cache
         with:
-          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION }}
+          key: ${{ steps.restore-storybook-build-cache.outputs.cache-primary-key }}
   front-sb-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: front-sb-build
     strategy:
       fail-fast: false
@@ -75,35 +68,26 @@ jobs:
     env:
       SHARD_COUNTER: 4
       REACT_APP_SERVER_BASE_URL: http://localhost:3000
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
     steps:
       - name: Fetch local actions
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build dependencies
-        run: |
-          npx nx build twenty-shared
-          npx nx build twenty-ui
-          npx nx build twenty-sdk
+        uses: ./.github/workflows/actions/yarn-install
       - name: Install Playwright
-        run: |
-          cd packages/twenty-front
-          npx playwright install
+        run: cd packages/twenty-front && npx playwright install
+      - name: Restore storybook build cache
+        uses: ./.github/workflows/actions/restore-cache
+        with:
+          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY }}
       - name: Front / Write .env
         run: npx nx reset:env twenty-front
       - name: Run storybook tests
-        run: npx nx storybook:test twenty-front --configuration=${{ matrix.storybook_scope }} --shard=${{ matrix.shard }}/${{ env.SHARD_COUNTER }}
+        run: npx nx storybook:serve-and-test:static twenty-front --configuration=${{ matrix.storybook_scope }} --shard=${{ matrix.shard }}/${{ env.SHARD_COUNTER }} --checkCoverage=false
       - name: Rename coverage file
-        run: |
-          if [ -f "packages/twenty-front/coverage/storybook/coverage-final.json" ]; then
-            mv packages/twenty-front/coverage/storybook/coverage-final.json packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
-          else
-            echo "Error: coverage-final.json not found"
-            ls -la packages/twenty-front/coverage/storybook/ || echo "Coverage directory does not exist"
-            exit 1
-          fi
+        run: mv packages/twenty-front/coverage/storybook/coverage-storybook.json packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
       - name: Upload coverage artifact
         uses: actions/upload-artifact@v4
         with:
@@ -112,7 +96,7 @@ jobs:
           path: packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
   merge-reports-and-check-coverage:
     timeout-minutes: 30
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04-8
     needs: front-sb-test
     env:
       PATH_TO_COVERAGE: packages/twenty-front/coverage/storybook
@@ -124,7 +108,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - uses: actions/download-artifact@v4
         with:
           pattern: coverage-artifacts-${{ matrix.storybook_scope }}-${{ github.run_id }}-*
@@ -138,36 +122,37 @@ jobs:
         run: npx nx storybook:coverage twenty-front --checkCoverage=true --configuration=${{ matrix.storybook_scope }}
   front-chromatic-deployment:
     timeout-minutes: 30
-    if: false
+    if: contains(github.event.pull_request.labels.*.name, 'run-chromatic') || github.event_name == 'push'
     needs: front-sb-build
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     env:
       REACT_APP_SERVER_BASE_URL: http://127.0.0.1:3000
       CHROMATIC_PROJECT_TOKEN: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - name: Restore storybook build cache
-        uses: ./.github/actions/restore-cache
+        uses: ./.github/workflows/actions/restore-cache
         with:
-          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION }}
+          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY }}
       - name: Front / Write .env
         run: |
           cd packages/twenty-front
           touch .env
-          echo "" >> .env
-          echo "REACT_APP_SERVER_BASE_URL=$REACT_APP_SERVER_BASE_URL" >> .env
+          echo "REACT_APP_SERVER_BASE_URL: $REACT_APP_SERVER_BASE_URL" >> .env
       - name: Publish to Chromatic
         run: npx nx run twenty-front:chromatic:ci
   front-task:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04-8
     env:
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
       TASK_CACHE_KEY: front-task-${{ matrix.task }}
     strategy:
       matrix:
@@ -182,171 +167,35 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - name: Restore ${{ matrix.task }} cache
         id: restore-task-cache
-        uses: ./.github/actions/restore-cache
+        uses: ./.github/workflows/actions/restore-cache
         with:
           key: ${{ env.TASK_CACHE_KEY }}
       - name: Reset .env
-        uses: ./.github/actions/nx-affected
+        uses: ./.github/workflows/actions/nx-affected
         with:
           tag: scope:frontend
           tasks: reset:env
       - name: Run ${{ matrix.task }} task
-        uses: ./.github/actions/nx-affected
+        uses: ./.github/workflows/actions/nx-affected
         with:
           tag: scope:frontend
           tasks: ${{ matrix.task }}
       - name: Save ${{ matrix.task }} cache
-        uses: ./.github/actions/save-cache
+        uses: ./.github/workflows/actions/save-cache
         with:
           key: ${{ steps.restore-task-cache.outputs.cache-primary-key }}
-  front-build:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
-    env:
-      NODE_OPTIONS: "--max-old-space-size=10240"
-    steps:
-      - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.11.0
-        with:
-          access_token: ${{ github.token }}
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Front / Write .env
-        run: npx nx reset:env twenty-front
-      - name: Build frontend
-        run: npx nx build twenty-front
-      - name: Upload frontend build artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: frontend-build
-          path: packages/twenty-front/build
-          retention-days: 1
-  e2e-test:
-    runs-on: ubuntu-latest
-    needs: [changed-files-check-e2e, front-build]
-    if: |
-      always() &&
-      needs.changed-files-check-e2e.outputs.any_changed == 'true' &&
-      (needs.front-build.result == 'success' || needs.front-build.result == 'skipped') &&
-      (github.event_name == 'push' || github.event_name == 'merge_group' || (github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, 'run-e2e')))
-    timeout-minutes: 30
-    env:
-      NODE_OPTIONS: "--max-old-space-size=10240"
-    services:
-      postgres:
-        image: twentycrm/twenty-postgres-spilo
-        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: "true"
-          SPILO_PROVIDER: "local"
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-node@v4
-        with:
-          node-version: lts/*
-
-      - name: Check system resources
-        run: |
-          echo "Available memory:"
-          free -h
-          echo "Available disk space:"
-          df -h
-          echo "CPU info:"
-          lscpu
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Build twenty-shared
-        run: npx nx build twenty-shared
-
-      - name: Install Playwright Browsers
-        run: npx nx setup twenty-e2e-testing
-
-      - name: Setup environment files
-        run: |
-          cp packages/twenty-front/.env.example packages/twenty-front/.env
-          npx nx reset:env:e2e-testing-server twenty-server
-
-      - name: Download frontend build artifact
-        if: needs.front-build.result == 'success'
-        uses: actions/download-artifact@v4
-        with:
-          name: frontend-build
-          path: packages/twenty-front/build
-
-      - name: Build frontend (if not available from front-build)
-        if: needs.front-build.result == 'skipped'
-        run: NODE_ENV=production NODE_OPTIONS="--max-old-space-size=10240" npx nx build twenty-front
-
-      - name: Build server
-        run: npx nx build twenty-server
-
-      - name: Create and setup database
-        run: |
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
-          npx nx run twenty-server:database:reset
-
-      - name: Start server
-        run: |
-          npx nx start twenty-server &
-          echo "Waiting for server to be ready..."
-          timeout 60 bash -c 'until curl -s http://localhost:3000/health; do sleep 2; done'
-
-      - name: Start frontend
-        run: |
-          npm_config_yes=true npx serve -s packages/twenty-front/build -l 3001 &
-          echo "Waiting for frontend to be ready..."
-          timeout 60 bash -c 'until curl -s http://localhost:3001; do sleep 2; done'
-
-      - name: Start worker
-        run: |
-          npx nx run twenty-server:worker &
-          echo "Worker started"
-
-      - name: Run Playwright tests
-        run: npx nx test twenty-e2e-testing
-
-      - uses: actions/upload-artifact@v4
-        if: always()
-        with:
-          name: playwright-report
-          path: packages/twenty-e2e-testing/run_results/
-          retention-days: 30
-
   ci-front-status-check:
     if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
+    timeout-minutes: 1
+    runs-on: depot-ubuntu-24.04-8
     needs:
       [
         changed-files-check,
         front-task,
-        front-build,
+        front-chromatic-deployment,
         merge-reports-and-check-coverage,
         front-sb-test,
         front-sb-build,
@@ -355,12 +204,3 @@ jobs:
       - name: Fail job if any needs failed
         if: contains(needs.*.result, 'failure')
         run: exit 1
-  ci-e2e-status-check:
-    if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
-    needs: [changed-files-check-e2e, e2e-test]
-    steps:
-      - name: Fail job if any needs failed
-        if: contains(needs.*.result, 'failure')
-        run: exit 1

.github/workflows/ci-release-create.yaml

@@ -1,9 +1,4 @@
 name: "Release: create"
-
-permissions:
-  contents: read
-  pull-requests: write
-
 on:
   workflow_dispatch:
     inputs:
@@ -18,42 +13,33 @@ on:
         default: true
         description: Create a release after merging the PR
 
-defaults:
-  run:
-    shell: bash --noprofile --norc -euo pipefail {0}
-
 jobs:
   create_pr:
     timeout-minutes: 10
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v2
         with:
           ref: ${{ github.event.inputs.ref }}
 
       - name: Sanitize version
         id: sanitize
-        env:
-          RAW_VERSION: ${{ github.event.inputs.version }}
         run: |
-          VERSION="${RAW_VERSION#v}"
-          printf 'version=%s\n' "$VERSION" >> "$GITHUB_OUTPUT"
+          echo version=$(echo ${{ github.event.inputs.version }} | sed 's/^v//') >> $GITHUB_OUTPUT
 
       - name: Update versions
-        env:
-          VERSION: ${{ steps.sanitize.outputs.version }}
         run: |
-          printf '%s\n' "$VERSION" > version.txt
+          echo ${{ steps.sanitize.outputs.version }} > version.txt
 
       - name: Create Pull Request
         uses: peter-evans/create-pull-request@v6
         with:
-          branch: release/${{ steps.sanitize.outputs.version }}
-          commit-message: "chore: release v${{ steps.sanitize.outputs.version }}"
-          committer: Github Action Deploy <github-action-deploy@twenty.com>
-          author: Github Action Deploy <github-action-deploy@twenty.com>
-          title: Release v${{ steps.sanitize.outputs.version }}
-          labels: |
-            release
-            ${{ github.event.inputs.create_release == true && 'create_release' || '' }}
+            branch: release/${{ steps.sanitize.outputs.version }}
+            commit-message: "chore: release v${{ steps.sanitize.outputs.version }}"
+            committer: Github Action Deploy <github-action-deploy@twenty.com>
+            author: Github Action Deploy <github-action-deploy@twenty.com>
+            title: Release v${{ steps.sanitize.outputs.version }}
+            labels: |
+              release
+              ${{ github.event.inputs.create_release == true && 'create_release' || '' }}

.github/workflows/ci-release-merge.yaml

@@ -1,17 +1,9 @@
 name: "Release: on merge"
-
-permissions:
-  contents: write
-
 on:
   pull_request:
     types:
       - closed
 
-defaults:
-  run:
-    shell: bash --noprofile --norc -euo pipefail {0}
-
 jobs:
   tag_and_release:
     timeout-minutes: 10
@@ -20,40 +12,33 @@ jobs:
     steps:
       - name: Check PR Author
         id: check_author
-        env:
-          PR_AUTHOR: ${{ github.event.pull_request.user.login }}
         run: |
-          set -euo pipefail
-          if [[ "$PR_AUTHOR" != "github-actions[bot]" ]]; then
-            echo "PR author ($PR_AUTHOR) is not trusted. Exiting."
+          if [[ "${{ github.event.pull_request.user.login }}" != "github-actions[bot]" ]]; then
+            echo "PR author (${AUTHOR}) is not trusted. Exiting."
             exit 1
           fi
 
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v2
         with:
           ref: main
 
       - name: Get version from PR title
         id: extract_version
-        env:
-          PR_TITLE: ${{ github.event.pull_request.title }}
         run: |
-          set -euo pipefail
-          VERSION=$(printf '%s' "$PR_TITLE" | sed -n 's/.*Release v\([0-9][0-9.]*\).*/\1/p')
+          VERSION=$(echo "${{ github.event.pull_request.title }}" | sed -n 's/.*Release v\([0-9.]*\).*/\1/p')
           if [ -z "$VERSION" ]; then
             echo "No valid version found in PR title. Exiting."
             exit 1
           fi
-          printf 'VERSION=%s\n' "$VERSION" >> "$GITHUB_ENV"
+          echo "VERSION=$VERSION" >> $GITHUB_ENV
 
       - name: Push new tag
         run: |
-          set -euo pipefail
           git config --global user.name 'Github Action Deploy'
           git config --global user.email 'github-action-deploy@twenty.com'
-          git tag "v${{ env.VERSION }}"
-          git push origin "v${{ env.VERSION }}"
+          git tag v${{ env.VERSION }}
+          git push origin v${{ env.VERSION }}
 
       - uses: release-drafter/release-drafter@v5
         if: contains(github.event.pull_request.labels.*.name, 'create_release')

.github/workflows/ci-sdk.yaml

@@ -1,101 +0,0 @@
-name: CI SDK
-
-on:
-  merge_group:
-
-  pull_request:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  changed-files-check:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        packages/twenty-sdk/**
-  sdk-test:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 30
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        task: [lint, typecheck, test:unit, storybook:build, storybook:test, test:integration]
-    steps:
-      - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.11.0
-        with:
-          access_token: ${{ github.token }}
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build
-        run: npx nx build twenty-sdk
-      - name: Install Playwright
-        if: contains(matrix.task, 'storybook')
-        run: npx playwright install chromium
-      - name: Run ${{ matrix.task }} task
-        uses: ./.github/actions/nx-affected
-        with:
-          tag: scope:sdk
-          tasks: ${{ matrix.task }}
-  sdk-e2e-test:
-    timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
-    needs: [changed-files-check, sdk-test]
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    services:
-      postgres:
-        image: twentycrm/twenty-postgres-spilo
-        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    env:
-      NODE_ENV: test
-    steps:
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build
-        run: npx nx build twenty-sdk
-      - name: Server / Create Test DB
-        run: |
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
-      - name: SDK / Run e2e Tests
-        uses: ./.github/actions/nx-affected
-        with:
-          tag: scope:sdk
-          tasks: test:e2e
-  ci-sdk-status-check:
-    if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
-    needs: [changed-files-check, sdk-test, sdk-e2e-test]
-    steps:
-      - name: Fail job if any needs failed
-        if: contains(needs.*.result, 'failure')
-        run: exit 1

.github/workflows/ci-server.yaml

@@ -1,16 +1,14 @@
 name: CI Server
-
 on:
+  push:
+    branches:
+      - main
+
   pull_request:
 
-  merge_group:
-
-permissions:
-  contents: read
-
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+  cancel-in-progress: true
 
 env:
   SERVER_SETUP_CACHE_KEY: server-setup
@@ -21,17 +19,16 @@ jobs:
     with:
       files: |
         package.json
-        yarn.lock
         packages/twenty-server/**
-        packages/twenty-front/src/generated/**
-        packages/twenty-front/src/generated-metadata/**
         packages/twenty-emails/**
         packages/twenty-shared/**
   server-setup:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
+    env:
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
     services:
       postgres:
         image: twentycrm/twenty-postgres-spilo
@@ -57,23 +54,23 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - name: Restore server setup
         id: restore-server-setup-cache
-        uses: ./.github/actions/restore-cache
+        uses: ./.github/workflows/actions/restore-cache
         with:
           key: ${{ env.SERVER_SETUP_CACHE_KEY }}
       - name: Build twenty-shared
         run: npx nx build twenty-shared
       - name: Server / Run lint & typecheck
-        uses: ./.github/actions/nx-affected
+        uses: ./.github/workflows/actions/nx-affected
         with:
           tag: scope:backend
           tasks: lint,typecheck
-      - name: Server / Write .env
-        run: npx nx reset:env twenty-server
       - name: Server / Build
         run: npx nx build twenty-server
+      - name: Server / Write .env
+        run: npx nx reset:env twenty-server
       - name: Server / Create DB
         run: |
           PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
@@ -90,86 +87,68 @@ jobs:
             # If worker failed for other reasons, fail the build
             exit $exit_code
           fi
-      - name: Server / Start
-        run: npx nx start:ci twenty-server &
-      - name: Waiting for server starting...
-        run: |
-          for i in {1..10}; do
-            if curl -f http://localhost:3000/healthz; then
-              echo "Server ready!"
-              exit 0
-            fi
-            echo "Waiting..."
-            sleep 2
-          done
-          echo "Server did not become healthy in time" >&2
-          exit 1
       - name: Server / Check for Pending Migrations
         run: |
+          METADATA_MIGRATION_OUTPUT=$(npx nx run twenty-server:typeorm migration:generate metadata-migration-check -d src/database/typeorm/metadata/metadata.datasource.ts || true)
+
           CORE_MIGRATION_OUTPUT=$(npx nx run twenty-server:typeorm migration:generate core-migration-check -d src/database/typeorm/core/core.datasource.ts || true)
 
+          METADATA_MIGRATION_FILE=$(ls packages/twenty-server/*metadata-migration-check.ts 2>/dev/null || echo "")
           CORE_MIGRATION_FILE=$(ls packages/twenty-server/*core-migration-check.ts 2>/dev/null || echo "")
 
-          if [ -n "$CORE_MIGRATION_FILE" ]; then
+          if [ -n "$METADATA_MIGRATION_FILE" ] || [ -n "$CORE_MIGRATION_FILE" ]; then
             echo "::error::Unexpected migration files were generated. Please create a proper migration manually."
+            echo "$METADATA_MIGRATION_OUTPUT"
             echo "$CORE_MIGRATION_OUTPUT"
 
-            rm -f packages/twenty-server/*core-migration-check.ts
-
+            rm -f packages/twenty-server/*metadata-migration-check.ts packages/twenty-server/*core-migration-check.ts
+            
             exit 1
           fi
       - name: GraphQL / Check for Pending Generation
+        if: steps.changed-files.outputs.any_changed == 'true'
         run: |
           # Run GraphQL generation commands
           npx nx run twenty-front:graphql:generate
           npx nx run twenty-front:graphql:generate --configuration=metadata
 
-          # Check if GraphQL generated files were modified
-          if ! git diff --quiet -- packages/twenty-front/src/generated packages/twenty-front/src/generated-metadata; then
+          # Check if any files were modified
+          if ! git diff --quiet; then
             echo "::error::GraphQL schema changes detected. Please run 'npx nx run twenty-front:graphql:generate' and 'npx nx run twenty-front:graphql:generate --configuration=metadata' and commit the changes."
-            echo ""
-            echo "The following GraphQL schema changes were detected:"
-            echo "==================================================="
-            git diff -- packages/twenty-front/src/generated packages/twenty-front/src/generated-metadata
-            echo "==================================================="
-            echo ""
-            echo "Please run 'npx nx run twenty-front:graphql:generate' and 'npx nx run twenty-front:graphql:generate --configuration=metadata' and commit the changes."
-            echo ""
             exit 1
           fi
       - name: Save server setup
-        uses: ./.github/actions/save-cache
+        uses: ./.github/workflows/actions/save-cache
         with:
           key: ${{ steps.restore-server-setup-cache.outputs.cache-primary-key }}
+
   server-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: server-setup
+    env:
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
     steps:
       - name: Fetch custom Github Actions and base branch history
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - name: Restore server setup
-        uses: ./.github/actions/restore-cache
+        uses: ./.github/workflows/actions/restore-cache
         with:
           key: ${{ env.SERVER_SETUP_CACHE_KEY }}
       - name: Server / Run Tests
-        uses: ./.github/actions/nx-affected
+        uses: ./.github/workflows/actions/nx-affected
         with:
           tag: scope:backend
           tasks: test
 
   server-integration-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: server-setup
-    strategy:
-      fail-fast: false
-      matrix:
-        shard: [1, 2, 3, 4, 5, 6, 7, 8]
     services:
       postgres:
         image: twentycrm/twenty-postgres-spilo
@@ -189,42 +168,25 @@ jobs:
         image: redis
         ports:
           - 6379:6379
-      clickhouse:
-        image: clickhouse/clickhouse-server:25.8.8
-        env:
-          CLICKHOUSE_PASSWORD: clickhousePassword
-          CLICKHOUSE_URL: "http://default:clickhousePassword@localhost:8123/twenty"
-        ports:
-          - 8123:8123
-          - 9000:9000
-        options: >-
-          --health-cmd "clickhouse-client --host=localhost --port=9000 --user=default --password=clickhousePassword --query='SELECT 1'"
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
     env:
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
       NODE_ENV: test
-      ANALYTICS_ENABLED: true
-      CLICKHOUSE_URL: "http://default:clickhousePassword@localhost:8123/twenty"
-      CLICKHOUSE_PASSWORD: clickhousePassword
-      SHARD_COUNTER: 8
     steps:
       - name: Fetch custom Github Actions and base branch history
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Update .env.test for integrations tests
+        uses: ./.github/workflows/actions/yarn-install
+      - name: Update .env.test for billing
         run: |
-          echo "" >> .env.test
           echo "IS_BILLING_ENABLED=true" >> .env.test
           echo "BILLING_STRIPE_API_KEY=test-api-key" >> .env.test
           echo "BILLING_STRIPE_BASE_PLAN_PRODUCT_ID=test-base-plan-product-id" >> .env.test
           echo "BILLING_STRIPE_WEBHOOK_SECRET=test-webhook-secret" >> .env.test
           echo "BILLING_PLAN_REQUIRED_LINK=http://localhost:3001/stripe-redirection" >> .env.test
       - name: Restore server setup
-        uses: ./.github/actions/restore-cache
+        uses: ./.github/workflows/actions/restore-cache
         with:
           key: ${{ env.SERVER_SETUP_CACHE_KEY }}
       - name: Server / Build
@@ -236,23 +198,24 @@ jobs:
       - name: Server / Create Test DB
         run: |
           PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
-      - name: Run ClickHouse migrations
-        run: npx nx clickhouse:migrate twenty-server
-      - name: Run ClickHouse seeds
-        run: npx nx clickhouse:seed twenty-server
       - name: Server / Run Integration Tests
-        uses: ./.github/actions/nx-affected
+        uses: ./.github/workflows/actions/nx-affected
         with:
           tag: scope:backend
           tasks: 'test:integration'
           configuration: 'with-db-reset'
-          args: --shard=${{ matrix.shard }}/${{ env.SHARD_COUNTER }}
+      - name: Server / Upload reset-logs file
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: reset-logs
+          path: reset-logs.log
   ci-server-status-check:
     if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
+    timeout-minutes: 1
+    runs-on: depot-ubuntu-24.04-8
     needs: [changed-files-check, server-setup, server-test, server-integration-test]
     steps:
-      - name: Fail job if any needs failed
+      - name: Fail job if any needs failed 
         if: contains(needs.*.result, 'failure')
         run: exit 1

.github/workflows/ci-shared.yaml

@@ -1,16 +1,14 @@
 name: CI Shared
-
 on:
-  merge_group:
+  push:
+    branches:
+      - main
 
   pull_request:
 
-permissions:
-  contents: read
-
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+  cancel-in-progress: true
 
 jobs:
   changed-files-check:
@@ -23,6 +21,8 @@ jobs:
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
     runs-on: ubuntu-latest
+    env:
+      NX_REJECT_UNKNOWN_LOCAL_CACHE: 0
     strategy:
       matrix:
         task: [lint, typecheck, test]
@@ -36,15 +36,15 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - name: Run ${{ matrix.task }} task
-        uses: ./.github/actions/nx-affected
+        uses: ./.github/workflows/actions/nx-affected
         with:
           tag: scope:frontend
           tasks: ${{ matrix.task }}
   ci-shared-status-check:
     if: always() && !cancelled()
-    timeout-minutes: 5
+    timeout-minutes: 1
     runs-on: ubuntu-latest
     needs: [changed-files-check, shared-test]
     steps:

.github/workflows/ci-test-docker-compose.yaml

@@ -1,16 +1,10 @@
-name: CI Docker Compose
-
-permissions:
-  contents: read
-
+name: 'Test Docker Compose'
 on:
-  merge_group:
-
   pull_request:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+  cancel-in-progress: true
 
 jobs:
   changed-files-check:
@@ -39,7 +33,6 @@ jobs:
           echo "Setting up .env file..."
           cp .env.example .env
           echo "Generating secrets..."
-          echo "" >> .env
           echo "# === Randomly generated secrets ===" >>.env
           echo "APP_SECRET=$(openssl rand -base64 32)" >>.env
           echo "PGPASSWORD_SUPERUSER=$(openssl rand -hex 16)" >>.env
@@ -91,7 +84,7 @@ jobs:
         working-directory: ./packages/twenty-docker/
   ci-test-docker-compose-status-check:
     if: always() && !cancelled()
-    timeout-minutes: 5
+    timeout-minutes: 1
     runs-on: ubuntu-latest
     needs: [changed-files-check, test]
     steps:

.github/workflows/ci-tinybird.yaml

@@ -0,0 +1,26 @@
+name: CI Tinybird
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'package.json'
+      - 'packages/twenty-tinybird/**'
+
+  pull_request:
+    paths:
+      - 'package.json'
+      - 'packages/twenty-tinybird/**'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ci:
+    uses: tinybirdco/ci/.github/workflows/ci.yml@main
+    with:
+      data_project_dir: packages/twenty-tinybird
+    secrets:
+      tb_admin_token: ${{ secrets.TB_ADMIN_TOKEN }}
+      tb_host: https://api.eu-central-1.aws.tinybird.co

.github/workflows/ci-utils.yaml

@@ -1,5 +1,4 @@
 name: CI Utils
-
 on:
   # it's usually not recommended to use pull_request_target
   # but we consider it's safe here if we keep the same steps
@@ -7,7 +6,6 @@ on:
   # and: https://github.com/facebook/react-native/pull/34370/files
   pull_request_target:
     types: [opened, synchronize, reopened, closed]
-
 permissions:
   actions: write
   checks: write
@@ -15,7 +13,6 @@ permissions:
   issues: write
   pull-requests: write
   statuses: write
-
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   # We don't cancel in-progress because this workflow is triggered on
@@ -24,18 +21,18 @@ concurrency:
 
 jobs:
   danger-js:
-    timeout-minutes: 5
+    timeout-minutes: 3
     runs-on: ubuntu-latest
     if: github.event.action != 'closed'
     steps:
       - uses: actions/checkout@v4
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - name: Utils / Run Danger.js
         run: cd packages/twenty-utils && npx nx danger:ci
         env:
           DANGER_GITHUB_API_TOKEN: ${{ github.token }}
-
+  
   congratulate:
     timeout-minutes: 3
     runs-on: ubuntu-latest
@@ -43,7 +40,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
       - name: Run congratulate-dangerfile.js
         run: cd packages/twenty-utils && npx nx danger:congratulate
         env:

.github/workflows/ci-website.yaml

@@ -1,16 +1,14 @@
 name: CI Website
-
-permissions:
-  contents: read
-
 on:
-  merge_group:
+  push:
+    branches:
+      - main
 
   pull_request:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+  cancel-in-progress: true
 
 jobs:
   changed-files-check:
@@ -45,7 +43,7 @@ jobs:
           fetch-depth: 0
 
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
 
       - name: Server / Create DB
         run: PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
@@ -64,7 +62,7 @@ jobs:
           NEXT_PUBLIC_KEYSTATIC_GITHUB_APP_SLUG: xxx
   ci-website-status-check:
     if: always() && !cancelled()
-    timeout-minutes: 5
+    timeout-minutes: 10
     runs-on: ubuntu-latest
     needs: [changed-files-check, website-build]
     steps:

.github/workflows/claude.yml

@@ -1,174 +0,0 @@
-name: Claude Code
-
-on:
-  issue_comment:
-    types: [created]
-  pull_request_review_comment:
-    types: [created]
-  pull_request_review:
-    types: [submitted]
-  issues:
-    types: [opened, assigned]
-  repository_dispatch:
-    types: [claude-core-team-issues]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.issue.number || github.event.pull_request.number || github.event.client_payload.issue_number }}
-  cancel-in-progress: false
-
-jobs:
-  claude:
-    if: |
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude') && github.event.comment.user.type != 'Bot') ||
-      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude') && github.event.comment.user.type != 'Bot') ||
-      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude') && github.event.review.user.type != 'Bot') ||
-      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      id-token: write
-    services:
-      postgres:
-        image: postgres:16
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: postgres
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Run Claude Code
-        id: claude-code
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          additional_permissions: |
-            actions: read
-          claude_args: '--max-turns 200 --model opus --allowedTools "Edit,Write,WebFetch,Bash(bash packages/twenty-utils/setup-dev-env.sh),Bash(npx nx *),Bash(npx jest *),Bash(yarn *),Bash(git *),Bash(gh *),Bash(sed *),Bash(python3 *),Bash(rm *),Bash(find *),Bash(grep *),Bash(cat *),Bash(ls *),Bash(head *),Bash(tail *),Bash(wc *),Bash(sort *),Bash(uniq *),Bash(mkdir *),Bash(cp *),Bash(mv *),Bash(touch *),Bash(chmod *),Bash(echo *),Bash(curl *),Bash(cd *),Bash(pwd *),Bash(diff *),Bash(xargs *),Bash(awk *),Bash(cut *),Bash(tee *),Bash(tr *)"'
-          settings: |
-            {
-              "env": {
-                "PG_DATABASE_URL": "postgres://postgres:postgres@localhost:5432/default"
-              }
-            }
-      - name: Post Create-PR link if Claude ran out of turns
-        if: failure()
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          BRANCH=$(git branch --show-current)
-          if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "" ]; then
-            exit 0
-          fi
-          AHEAD=$(git rev-list --count main.."$BRANCH" 2>/dev/null || echo "0")
-          if [ "$AHEAD" = "0" ]; then
-            exit 0
-          fi
-          EXISTING_PR=$(gh pr list --head "$BRANCH" --json number --jq '.[0].number' 2>/dev/null || echo "")
-          if [ -n "$EXISTING_PR" ]; then
-            exit 0
-          fi
-          ISSUE_NUMBER="${{ github.event.issue.number || github.event.pull_request.number }}"
-          ENCODED_BRANCH=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$BRANCH', safe=''))")
-          PR_URL="https://github.com/${{ github.repository }}/compare/main...${ENCODED_BRANCH}?quick_pull=1"
-          BODY="⚠️ Claude ran out of turns before creating a PR. Work has been pushed to [\`$BRANCH\`](https://github.com/${{ github.repository }}/tree/$ENCODED_BRANCH).\n\n[**Create PR →**]($PR_URL)"
-          if [ -n "$ISSUE_NUMBER" ]; then
-            gh issue comment "$ISSUE_NUMBER" --body "$(echo -e "$BODY")"
-          fi
-
-  claude-cross-repo:
-    if: github.event_name == 'repository_dispatch'
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      id-token: write
-    services:
-      postgres:
-        image: postgres:16
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: postgres
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build prompt from dispatch payload
-        id: prompt
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const p = context.payload.client_payload;
-            let prompt;
-            if (p.comment_body) {
-              prompt = `You are responding to a comment on issue #${p.issue_number} ("${p.issue_title}") in the ${p.repo_full_name} repository.\n\nThe comment by @${p.sender} says:\n\n${p.comment_body}\n\nIssue body:\n\n${p.issue_body}\n\nPlease help with this request. The code you are working with is the twenty codebase (this repository).`;
-            } else {
-              prompt = `You are responding to issue #${p.issue_number} ("${p.issue_title}") in the ${p.repo_full_name} repository, opened by @${p.sender}.\n\nIssue body:\n\n${p.issue_body}\n\nPlease help with this request. The code you are working with is the twenty codebase (this repository).`;
-            }
-            core.setOutput('prompt', prompt);
-            core.setOutput('repo', p.repo_full_name);
-            core.setOutput('issue_number', p.issue_number);
-      - name: Run Claude Code
-        id: claude
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          prompt: ${{ steps.prompt.outputs.prompt }}
-          additional_permissions: |
-            actions: read
-          claude_args: '--max-turns 200 --model opus --allowedTools "Edit,Write,WebFetch,Bash(bash packages/twenty-utils/setup-dev-env.sh),Bash(npx nx *),Bash(npx jest *),Bash(yarn *),Bash(git *),Bash(gh *),Bash(sed *),Bash(python3 *),Bash(rm *),Bash(find *),Bash(grep *),Bash(cat *),Bash(ls *),Bash(head *),Bash(tail *),Bash(wc *),Bash(sort *),Bash(uniq *),Bash(mkdir *),Bash(cp *),Bash(mv *),Bash(touch *),Bash(chmod *),Bash(echo *),Bash(curl *),Bash(cd *),Bash(pwd *),Bash(diff *),Bash(xargs *),Bash(awk *),Bash(cut *),Bash(tee *),Bash(tr *)"'
-          settings: |
-            {
-              "env": {
-                "PG_DATABASE_URL": "postgres://postgres:postgres@localhost:5432/default"
-              }
-            }
-      - name: Post response to source issue
-        if: always()
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.TWENTY_DISPATCH_TOKEN }}
-          script: |
-            const [owner, repo] = '${{ steps.prompt.outputs.repo }}'.split('/');
-            const issueNumber = parseInt('${{ steps.prompt.outputs.issue_number }}', 10);
-
-            await github.rest.issues.createComment({
-              owner,
-              repo,
-              issue_number: issueNumber,
-              body: `Claude finished processing this request. [See workflow run](${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId})`
-            });

.github/workflows/docs-i18n-pull.yaml

@@ -1,152 +0,0 @@
-name: 'Pull docs translations from Crowdin'
-
-permissions:
-  contents: write
-  pull-requests: write
-
-on:
-  schedule:
-    - cron: '0 */2 * * *' # Every two hours
-  workflow_dispatch:
-    inputs:
-      force_pull:
-        description: 'Force pull translations regardless of status'
-        required: false
-        type: boolean
-        default: false
-  workflow_call:
-    inputs:
-      force_pull:
-        description: 'Force pull translations regardless of status'
-        required: false
-        type: boolean
-        default: false
-  pull_request:
-    paths:
-      - 'packages/twenty-docs/**'
-      - '.github/crowdin-docs.yml'
-      - '.github/workflows/docs-i18n-pull.yaml'
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  pull_docs_translations:
-    name: Pull docs translations
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          token: ${{ github.token }}
-          ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Setup i18n-docs branch
-        if: github.event_name != 'pull_request'
-        run: |
-          git fetch origin i18n-docs || true
-          git checkout -B i18n-docs origin/i18n-docs || git checkout -b i18n-docs
-
-      - name: Configure git
-        run: |
-          git config --global user.name 'github-actions'
-          git config --global user.email 'github-actions@twenty.com'
-
-      - name: Stash any changes before pulling translations
-        if: github.event_name != 'pull_request'
-        run: |
-          git add .
-          git stash || true
-
-      # Install Crowdin CLI for downloading translations
-      - name: Install Crowdin CLI
-        if: github.event_name != 'pull_request' && (inputs.force_pull == true || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
-        run: npm install -g @crowdin/cli
-
-      # Pull docs translations from Crowdin one language at a time
-      # This avoids build timeout issues when processing all languages at once
-      - name: Pull translated docs from Crowdin
-        if: github.event_name != 'pull_request' && (inputs.force_pull == true || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
-        run: |
-          # Languages supported by Mintlify (see packages/twenty-docs/src/shared/supported-languages.ts)
-          LANGUAGES="fr ar cs de es it ja ko pt ro ru tr zh-CN"
-
-          for lang in $LANGUAGES; do
-            echo "=== Pulling translations for $lang ==="
-            crowdin download \
-              --config .github/crowdin-docs.yml \
-              --token "$CROWDIN_PERSONAL_TOKEN" \
-              --base-url "https://twenty.api.crowdin.com" \
-              --language "$lang" \
-              --skip-untranslated-strings=false \
-              --skip-untranslated-files=false \
-              --export-only-approved=false \
-              --verbose || echo "Warning: Failed to pull $lang, continuing with other languages..."
-            echo ""
-          done
-
-          echo "=== Download complete ==="
-        env:
-          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
-
-      - name: Fix file permissions
-        if: github.event_name != 'pull_request'
-        run: sudo chown -R runner:docker . || true
-
-      - name: Fix translated documentation links
-        run: bash packages/twenty-docs/scripts/fix-translated-links.sh
-
-      - name: Regenerate navigation template
-        if: github.event_name == 'pull_request'
-        run: yarn docs:generate-navigation-template
-
-      - name: Regenerate docs.json
-        run: yarn docs:generate
-
-      - name: Regenerate documentation paths constants
-        run: yarn docs:generate-paths
-
-      - name: Commit artifacts to pull request branch
-        if: github.event_name == 'pull_request'
-        run: |
-          git add packages/twenty-docs/docs.json packages/twenty-docs/navigation/navigation.template.json packages/twenty-shared/src/constants/DocumentationPaths.ts
-          if git diff --staged --quiet --exit-code; then
-            echo "No navigation/doc changes to commit."
-            exit 0
-          fi
-          git commit -m "chore: sync docs artifacts"
-          git push origin "HEAD:$HEAD_REF"
-        env:
-          HEAD_REF: ${{ github.head_ref }}
-
-      - name: Check for changes and commit
-        if: github.event_name != 'pull_request'
-        id: check_changes
-        run: |
-          git add .
-          if ! git diff --staged --quiet --exit-code; then
-            git commit -m "chore: update docs translations from Crowdin and fix internal links"
-            echo "changes_detected=true" >> $GITHUB_OUTPUT
-          else
-            echo "changes_detected=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Push changes
-        if: github.event_name != 'pull_request' && steps.check_changes.outputs.changes_detected == 'true'
-        run: git push origin HEAD:i18n-docs
-
-      - name: Create pull request
-        if: github.event_name != 'pull_request' && steps.check_changes.outputs.changes_detected == 'true'
-        run: |
-          if git diff --name-only origin/main..HEAD | grep -q .; then
-            gh pr create -B main -H i18n-docs --title 'i18n - docs translations' --body 'Created by Github action' || true
-          else
-            echo "No file differences between branches, skipping PR creation"
-          fi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-

.github/workflows/docs-i18n-push.yaml

@@ -1,51 +0,0 @@
-name: 'Push docs to Crowdin'
-
-permissions:
-  contents: write
-
-on:
-  workflow_dispatch:
-  workflow_call:
-  push:
-    branches: ['main']
-    paths:
-      - 'packages/twenty-docs/**/*.mdx'
-      - '!packages/twenty-docs/l/**'
-      - 'packages/twenty-docs/navigation/navigation.template.json'
-      - '.github/crowdin-docs.yml'
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  push_docs:
-    name: Push documentation to Crowdin
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          token: ${{ github.token }}
-          ref: ${{ github.ref }}
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Generate navigation template for Crowdin
-        run: yarn docs:generate-navigation-template
-
-      - name: Upload docs to Crowdin
-        uses: crowdin/github-action@v2
-        with:
-          upload_sources: true
-          upload_translations: false
-          download_translations: false
-          localization_branch_name: i18n-docs
-          base_url: 'https://twenty.api.crowdin.com'
-          config: '.github/crowdin-docs.yml'
-        env:
-          # Docs translations project
-          CROWDIN_PROJECT_ID: '2'
-          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
-

.github/workflows/i18n-pull.yaml

@@ -3,10 +3,6 @@
 
 name: 'Pull translations from Crowdin'
 
-permissions:
-  contents: write
-  pull-requests: write
-
 on:
   schedule:
     - cron: '0 */2 * * *' # Every two hours.
@@ -27,12 +23,16 @@ on:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+  cancel-in-progress: true
 
 jobs:
   pull_translations:
     name: Pull translations
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -46,7 +46,7 @@ jobs:
           git checkout -B i18n origin/i18n || git checkout -b i18n
 
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
 
       - name: Build twenty-shared
         run: npx nx build twenty-shared
@@ -74,8 +74,6 @@ jobs:
           upload_sources: false
           upload_translations: false
           download_translations: true
-          source: '**/en.po'
-          translation: '%original_path%/%locale%.po'
           export_only_approved: false
           localization_branch_name: i18n
           base_url: 'https://twenty.api.crowdin.com'
@@ -85,37 +83,30 @@ jobs:
           push_sources: false
           skip_untranslated_strings: false
           skip_untranslated_files: false
-          push_translations: false
+          push_translations: true
           create_pull_request: false
           skip_ref_checkout: true
           dryrun_action: false
-          config: '.github/crowdin-app.yml'
         env:
           GITHUB_TOKEN: ${{ github.token }}
-          # App translations project
           CROWDIN_PROJECT_ID: '1'
           CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
-
+      
       # As the files are extracted from a Docker container, they belong to root:root
       # We need to fix this before the next steps
       - name: Fix file permissions
         run: sudo chown -R runner:docker .
 
-      # Fix encoding issues (escaped Unicode like \u62db -> 招) and push fixes back to Crowdin
-      - name: Fix translation encoding and sync to Crowdin
-        run: npx ts-node packages/twenty-utils/fix-crowdin-translations.ts
-        env:
-          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
-
       - name: Compile translations
         id: compile_translations
-        # Because we have set English as a fallback locale, this condition does not work anymore
-        # if: inputs.force_pull || steps.compile_translations_strict.outcome == 'failure'
+        if: inputs.force_pull || steps.compile_translations_strict.outcome == 'failure'
         run: |
           npx nx run twenty-server:lingui:compile
-          npx nx run twenty-emails:lingui:compile
+          npx nx run twenty-emails:lingui:compile 
           npx nx run twenty-front:lingui:compile
           git status
+          git config --global user.name 'github-actions'
+          git config --global user.email 'github-actions@twenty.com'
           git add .
           if ! git diff --staged --quiet --exit-code; then
             git commit -m "chore: compile translations"

.github/workflows/i18n-push.yaml

@@ -1,9 +1,5 @@
 name: 'Push translations to Crowdin'
 
-permissions:
-  contents: write
-  pull-requests: write
-
 on:
   workflow_dispatch:
   workflow_call:
@@ -12,12 +8,15 @@ on:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+  cancel-in-progress: true
 
 jobs:
   extract_translations:
     name: Extract and upload translations
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -31,7 +30,7 @@ jobs:
           git checkout -B i18n origin/i18n || git checkout -b i18n
 
       - name: Install dependencies
-        uses: ./.github/actions/yarn-install
+        uses: ./.github/workflows/actions/yarn-install
 
       - name: Build dependencies
         run: npx nx build twenty-shared
@@ -87,10 +86,11 @@ jobs:
           download_translations: false
           localization_branch_name: i18n
           base_url: 'https://twenty.api.crowdin.com'
-          config: '.github/crowdin-app.yml'
         env:
-          # App translations project
-          CROWDIN_PROJECT_ID: '1'
+          # A numeric ID, found at https://crowdin.com/project/<projectName>/tools/api
+          CROWDIN_PROJECT_ID: 1
+
+          # Visit https://crowdin.com/settings#api-key to create this token
           CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
       - name: Create a pull request
         if: steps.check_extract_changes.outputs.changes_detected == 'true' || steps.check_compile_changes.outputs.changes_detected == 'true'

.github/workflows/i18n-qa-report.yaml

@@ -1,118 +0,0 @@
-# Weekly translation QA report using Crowdin's native QA checks
-
-name: 'Weekly Translation QA Report'
-
-permissions:
-  contents: write
-  pull-requests: write
-
-on:
-  schedule:
-    - cron: '0 9 * * 1' # Every Monday at 9am UTC
-  workflow_dispatch: # Allow manual trigger
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-
-jobs:
-  qa_report:
-    name: Generate QA Report
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Build twenty-shared
-        run: npx nx build twenty-shared
-
-      - name: Generate QA report from Crowdin
-        id: generate_report
-        run: |
-          npx ts-node packages/twenty-utils/translation-qa-report.ts || true
-          if [ -f TRANSLATION_QA_REPORT.md ]; then
-            echo "report_generated=true" >> $GITHUB_OUTPUT
-            # Count critical issues (exclude spellcheck)
-            CRITICAL=$(grep -oP '⚠️\s+\K\d+' TRANSLATION_QA_REPORT.md 2>/dev/null || echo "0")
-            echo "critical_issues=$CRITICAL" >> $GITHUB_OUTPUT
-          else
-            echo "report_generated=false" >> $GITHUB_OUTPUT
-            echo "critical_issues=0" >> $GITHUB_OUTPUT
-          fi
-        env:
-          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
-
-      - name: Create QA branch and commit report
-        if: steps.generate_report.outputs.report_generated == 'true'
-        run: |
-          git config --global user.name 'github-actions'
-          git config --global user.email 'github-actions@twenty.com'
-
-          BRANCH_NAME="i18n-qa-report-$(date +%Y-%m-%d)"
-          git checkout -B $BRANCH_NAME
-
-          git add TRANSLATION_QA_REPORT.md
-          if ! git diff --staged --quiet --exit-code; then
-            git commit -m "docs: weekly translation QA report"
-            git push origin HEAD:$BRANCH_NAME --force
-            echo "BRANCH_NAME=$BRANCH_NAME" >> $GITHUB_ENV
-          else
-            echo "No changes to commit"
-            echo "BRANCH_NAME=" >> $GITHUB_ENV
-          fi
-
-      - name: Create pull request
-        if: steps.generate_report.outputs.report_generated == 'true' && env.BRANCH_NAME != ''
-        run: |
-          CRITICAL="${{ steps.generate_report.outputs.critical_issues }}"
-
-          BODY=$(cat <<EOF
-          ## Weekly Translation QA Report
-
-          **Critical issues (excluding spellcheck): $CRITICAL**
-
-          📊 **View in Crowdin**: https://twenty.crowdin.com/u/projects/1/all?filter=qa-issue
-
-          ### For AI-Assisted Fixing
-
-          Open this PR in Cursor and say:
-
-          > "Fix the translation QA issues using the Crowdin API"
-
-          The AI can help fix:
-          - ✅ Variables mismatch (missing/wrong placeholders)
-          - ✅ Escaped Unicode sequences
-          - ⚠️ Tags mismatch
-          - ⚠️ Empty translations
-
-          ### Available Scripts
-
-          \`\`\`bash
-          # View QA report
-          CROWDIN_PERSONAL_TOKEN=xxx npx ts-node packages/twenty-utils/translation-qa-report.ts
-
-          # Fix encoding issues automatically
-          CROWDIN_PERSONAL_TOKEN=xxx npx ts-node packages/twenty-utils/fix-crowdin-translations.ts
-          \`\`\`
-
-          ---
-          *Close without merging after issues are addressed*
-          EOF
-          )
-
-          EXISTING_PR=$(gh pr list --head $BRANCH_NAME --json number --jq '.[0].number' 2>/dev/null || echo "")
-
-          if [ -n "$EXISTING_PR" ]; then
-            gh pr edit $EXISTING_PR --body "$BODY"
-          else
-            gh pr create \
-              --base main \
-              --head $BRANCH_NAME \
-              --title "i18n: Translation QA Report ($CRITICAL critical issues)" \
-              --body "$BODY" || true
-          fi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/preview-env-dispatch.yaml

@@ -1,37 +0,0 @@
-name: 'Preview Environment Dispatch'
-
-permissions:
-  contents: write
-  actions: write
-  pull-requests: read
-
-on:
-  # Using pull_request_target instead of pull_request to have access to secrets for external contributors
-  # Security note: This is safe because we're only using the repository-dispatch action with limited scope
-  # and not checking out or running any code from the external contributor's PR
-  pull_request_target:
-    types: [opened, synchronize, reopened, labeled]
-    paths:
-      - packages/twenty-docker/**
-      - packages/twenty-server/**
-      - packages/twenty-front/**
-      - .github/workflows/preview-env-dispatch.yaml
-      - .github/workflows/preview-env-keepalive.yaml
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  trigger-preview:
-    if: github.event.action == 'opened' || github.event.action == 'synchronize' || github.event.action == 'reopened' || (github.event.action == 'labeled' && github.event.label.name == 'preview-app')
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
-    steps:
-      - name: Trigger preview environment workflow
-        uses: peter-evans/repository-dispatch@v2
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          repository: ${{ github.repository }}
-          event-type: preview-environment
-          client-payload: '{"pr_number": "${{ github.event.pull_request.number }}", "pr_head_sha": "${{ github.event.pull_request.head.sha }}", "repo_full_name": "${{ github.repository }}"}'

.github/workflows/preview-env-keepalive.yaml

@@ -1,159 +0,0 @@
-name: 'Preview Environment Keep Alive'
-
-permissions:
-  contents: read
-  pull-requests: write
-
-on:
-  repository_dispatch:
-    types: [preview-environment]
-
-jobs:
-  preview-environment:
-    timeout-minutes: 310
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout PR
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.client_payload.pr_head_sha }}
-      
-      - name: Run compose setup
-        run: |
-          echo "Patching docker-compose.yml..."
-          # change image to localbuild using yq
-          yq eval 'del(.services.server.image)' -i packages/twenty-docker/docker-compose.yml
-          yq eval '.services.server.build.context = "../../"' -i packages/twenty-docker/docker-compose.yml
-          yq eval '.services.server.build.dockerfile = "./packages/twenty-docker/twenty/Dockerfile"' -i packages/twenty-docker/docker-compose.yml
-          
-          yq eval 'del(.services.worker.image)' -i packages/twenty-docker/docker-compose.yml
-          yq eval '.services.worker.build.context = "../../"' -i packages/twenty-docker/docker-compose.yml
-          yq eval '.services.worker.build.dockerfile = "./packages/twenty-docker/twenty/Dockerfile"' -i packages/twenty-docker/docker-compose.yml
-          
-          echo "Adding SIGN_IN_PREFILLED environment variable to server service..."
-          yq eval '.services.server.environment.SIGN_IN_PREFILLED = "${SIGN_IN_PREFILLED}"' -i packages/twenty-docker/docker-compose.yml
-          
-          echo "Setting up .env file..."
-          cp packages/twenty-docker/.env.example packages/twenty-docker/.env
-          
-          echo "Generating secrets..."
-          echo "" >> packages/twenty-docker/.env
-          echo "# === Randomly generated secrets ===" >> packages/twenty-docker/.env
-          echo "APP_SECRET=$(openssl rand -base64 32)" >> packages/twenty-docker/.env
-          echo "PG_DATABASE_PASSWORD=$(openssl rand -hex 16)" >> packages/twenty-docker/.env
-          echo "SIGN_IN_PREFILLED=true" >> packages/twenty-docker/.env
-          echo "Docker compose build..."
-          cd packages/twenty-docker/
-          docker compose build
-        working-directory: ./
-      
-      - name: Create Tunnel
-        id: expose-tunnel
-        uses: codetalkio/expose-tunnel@v1.5.0
-        with:
-          service: bore.pub
-          port: 3000
-      
-      - name: Start services with correct SERVER_URL
-        run: |
-          cd packages/twenty-docker/
-          
-          # Update the SERVER_URL with the tunnel URL
-          echo "Setting SERVER_URL to ${{ steps.expose-tunnel.outputs.tunnel-url }}"
-          sed -i '/SERVER_URL=/d' .env
-          echo "" >> .env
-          echo "SERVER_URL=${{ steps.expose-tunnel.outputs.tunnel-url }}" >> .env
-          
-          # Start the services
-          echo "Docker compose up..."
-          docker compose up -d || {
-              echo "Docker compose failed to start"
-              docker compose logs
-              exit 1
-          }
-          
-          echo "Waiting for services to be ready..."
-          count=0
-          while [ ! $(docker inspect --format='{{.State.Health.Status}}' twenty-db-1) = "healthy" ] || [ ! $(docker inspect --format='{{.State.Health.Status}}' twenty-server-1) = "healthy" ]; do
-              sleep 5
-              count=$((count+1))
-              if [ $count -gt 60 ]; then
-                  echo "Timeout waiting for services to be ready"
-                  docker compose logs
-                  exit 1
-              fi
-              echo "Still waiting for services... ($count/60)"
-          done
-          
-          echo "All services are up and running!"
-        working-directory: ./
-
-      - name: Seed Dev Workspace
-        run: |
-          cd packages/twenty-docker/
-          echo "Seeding full dev workspace..."
-          if ! docker compose exec -T server yarn command:prod -- workspace:seed:dev; then
-            echo "❌ Seeding full dev workspace failed. Dumping server logs..."
-            docker compose logs server
-            exit 1
-          fi
-        working-directory: ./
-
-      - name: Output tunnel URL to logs
-        run: |
-          echo "✅ Preview Environment Ready!"
-          echo "🔗 Preview URL: ${{ steps.expose-tunnel.outputs.tunnel-url }}"
-          echo "⏱️ This environment will be available for 5 hours"
-      
-      - name: Post comment on PR
-        uses: actions/github-script@v6
-        with:
-          github-token: ${{secrets.GITHUB_TOKEN}}
-          script: |
-            const COMMENT_MARKER = '<!-- PR_PREVIEW_ENV -->';
-            const commentBody = `${COMMENT_MARKER}
-            🚀 **Preview Environment Ready!**
-            
-            Your preview environment is available at: ${{ steps.expose-tunnel.outputs.tunnel-url }}
-            
-            This environment will automatically shut down when the PR is closed or after 5 hours.`;
-            
-            // Get all comments
-            const {data: comments} = await github.rest.issues.listComments({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: ${{ github.event.client_payload.pr_number }},
-            });
-            
-            // Find our comment
-            const botComment = comments.find(comment => comment.body.includes(COMMENT_MARKER));
-            
-            if (botComment) {
-              // Update existing comment
-              await github.rest.issues.updateComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                comment_id: botComment.id,
-                body: commentBody
-              });
-              console.log('Updated existing comment');
-            } else {
-              // Create new comment
-              await github.rest.issues.createComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: ${{ github.event.client_payload.pr_number }},
-                body: commentBody
-              });
-              console.log('Created new comment');
-            }
-      
-      - name: Keep tunnel alive for 5 hours
-        run: timeout 300m sleep 18000 # Stop on whichever we reach first (300m or 5hour sleep)
-      
-      - name: Cleanup
-        if: always()
-        run: |
-          cd packages/twenty-docker/
-          docker compose down -v
-        working-directory: ./ 

.gitignore

@@ -9,7 +9,6 @@
 
 .nx/installation
 .nx/cache
-.nx/workspace-data
 
 .pnp.*
 .yarn/*
@@ -43,9 +42,4 @@ dump.rdb
 /flake.lock
 /flake.nix
 
-.crowdin.yml
-.react-email/
-
-mcp.json
-/.junie/
-TRANSLATION_QA_REPORT.md
+.crowdin.yml

.mcp.json

@@ -1,22 +0,0 @@
-{
-  "mcpServers": {
-    "postgres": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-postgres", "${PG_DATABASE_URL}"],
-      "env": {}
-    },
-    "playwright": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["@playwright/mcp@latest", "--no-sandbox", "--headless"],
-      "env": {}
-    },
-    "context7": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"],
-      "env": {}
-    }
-  }
-}

.nvmrc

@@ -1 +1 @@
-24.5.0
+18.17.1

.prettierignore

@@ -0,0 +1,4 @@
+# Add files here to ignore them from prettier formatting
+/dist
+/coverage
+/.nx/cache

.prettierrc

@@ -0,0 +1,5 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "endOfLine": "auto"
+}

.vscode/launch.json

@@ -5,10 +5,13 @@
     {
       "name": "twenty-server - start debug",
       "type": "node",
-      "runtimeVersion": "24.5",
       "request": "launch",
       "runtimeExecutable": "npx",
-      "runtimeArgs": ["nx", "run", "twenty-server:start"],
+      "runtimeArgs": [
+        "nx",
+        "run",
+        "twenty-server:start"
+      ],
       "outputCapture": "std",
       "internalConsoleOptions": "openOnSessionStart",
       "console": "internalConsole",
@@ -19,7 +22,11 @@
       "type": "node",
       "request": "launch",
       "runtimeExecutable": "npx",
-      "runtimeArgs": ["nx", "run", "twenty-server:worker"],
+      "runtimeArgs": [
+        "nx",
+        "run",
+        "twenty-server:worker"
+      ],
       "outputCapture": "std",
       "internalConsoleOptions": "openOnSessionStart",
       "console": "internalConsole",
@@ -30,7 +37,7 @@
       "type": "node",
       "request": "launch",
       "runtimeExecutable": "npx",
-      "runtimeVersion": "24.5",
+      "runtimeVersion": "18",
       "runtimeArgs": [
         "nx",
         "run",
@@ -66,30 +73,6 @@
         "--",
         "--config",
         "./jest-integration.config.ts",
-        "${relativeFile}",
-        "--silent=false",
-        "${input:updateSnapshot}"
-      ],
-      "cwd": "${workspaceFolder}/packages/twenty-server",
-      "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen",
-      "env": {
-        "NODE_ENV": "test",
-        "NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
-      }
-    },
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "twenty-server - debug unit test file (to launch with test file open)",
-      "runtimeExecutable": "npx",
-      "runtimeArgs": [
-        "nx",
-        "run",
-        "twenty-server:jest",
-        "--",
-        "--config",
-        "./jest.config.mjs",
         "${relativeFile}"
       ],
       "cwd": "${workspaceFolder}/packages/twenty-server",
@@ -97,16 +80,7 @@
       "internalConsoleOptions": "neverOpen",
       "env": {
         "NODE_ENV": "test"
-      }
-    }
-  ],
-  "inputs": [
-    {
-      "id": "updateSnapshot",
-      "type": "pickString",
-      "description": "Update snapshots?",
-      "options": ["", "--updateSnapshot"],
-      "default": ""
+      },
     }
   ]
-}
+}

.vscode/settings.json

@@ -1,8 +1,6 @@
 {
   "editor.formatOnSave": false,
-  "files.eol": "\n",
-  "files.insertFinalNewline": true,
-  "files.trimTrailingWhitespace": true,
+  "files.eol": "auto",
   "[typescript]": {
     "editor.formatOnSave": false,
     "editor.codeActionsOnSave": {
@@ -31,7 +29,6 @@
     "editor.formatOnSave": true
   },
   "javascript.format.enable": false,
-  "javascript.preferences.importModuleSpecifier": "non-relative",
   "typescript.format.enable": false,
   "cSpell.enableFiletypes": [
     "!javascript",
@@ -46,13 +43,12 @@
   ],
   "typescript.preferences.importModuleSpecifier": "non-relative",
   "search.exclude": {
-    "**/.yarn": true
+    "**/.yarn": true,
   },
   "eslint.debug": true,
   "files.associations": {
     ".cursorrules": "markdown"
   },
-  "jestrunner.codeLensSelector": "**/*.{test,spec,integration-spec}.{js,jsx,ts,tsx}",
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "typescript.experimental.useTsgo": false
+  "jestrunner.codeLensSelector": "**/*.{test,spec,integration-spec}.{js,jsx,ts,tsx}"
+  }
 }

.vscode/tasks.json

@@ -2,64 +2,12 @@
 	"version": "2.0.0",
 	"tasks": [
 		{
-			"label": "twenty-server - run integration test file",
-			"type": "shell",
-			"command": "npx nx run twenty-server:jest -- --config ./jest-integration.config.ts ${relativeFile} --silent=false ${input:watchMode} ${input:updateSnapshot}",
-			"options": {
-				"cwd": "${workspaceFolder}/packages/twenty-server",
-				"env": {
-					"NODE_ENV": "test",
-					"NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
-				},
-				"shell": {
-					"executable": "/bin/zsh",
-					"args": ["-l", "-c"]
-				}
-			},
-			"presentation": {
-				"reveal": "always",
-				"panel": "new",
-				"close": false
-			},
-			"problemMatcher": []
-		},
-		{
-			"label": "twenty-server - run unit test file",
-			"type": "shell",
-			"command": "npx nx run twenty-server:jest -- --config ./jest.config.mjs ${relativeFile} --silent=false ${input:watchMode} ${input:updateSnapshot}",
-			"options": {
-				"cwd": "${workspaceFolder}/packages/twenty-server",
-				"env": {
-					"NODE_ENV": "test",
-					"NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
-				},
-				"shell": {
-					"executable": "/bin/zsh",
-					"args": ["-l", "-c"]
-				}
-			},
-			"presentation": {
-				"reveal": "always",
-				"panel": "new",
-				"close": false
-			},
-			"problemMatcher": []
-		}
-	],
-	"inputs": [
-		{
-			"id": "watchMode",
-			"type": "pickString",
-			"description": "Enable watch mode?",
-			"options": ["", "--watch"],
-			"default": ""
-		},
-		{
-			"id": "updateSnapshot",
-			"type": "pickString",
-			"description": "Update snapshots?",
-			"options": ["", "--updateSnapshot"],
-			"default": ""
+			"type": "npm",
+			"script": "start",
+			"path": "server",
+			"problemMatcher": [],
+			"label": "yarn: start - server",
+			"detail": "yarn start"
 		}
 	]
-}
+}

.vscode/twenty.code-workspace

@@ -4,6 +4,10 @@
       "name": "ROOT",
       "path": "../"
     },
+    {
+      "name": "packages/twenty-chrome-extension",
+      "path": "../packages/twenty-chrome-extension"
+    },
     {
       "name": "packages/twenty-docker",
       "path": "../packages/twenty-docker"

.yarn/patches/react-phone-number-input-npm-3.4.5-dc2895c306.patch

@@ -1,45 +0,0 @@
-diff --git a/commonjs/helpers/phoneInputHelpers.js b/commonjs/helpers/phoneInputHelpers.js
-index 8fd1b16ec670ab7d0abcb800a2edd7848e86ce1e..ab6e0dd90def507629c2ead59fba929a739f0759 100644
---- a/commonjs/helpers/phoneInputHelpers.js
-+++ b/commonjs/helpers/phoneInputHelpers.js
-@@ -574,7 +574,9 @@ function onPhoneDigitsChange(phoneDigits, _ref5) {
-   // Generate the new `value` property.
-   var value;
-   if (phoneDigits) {
--    if (phoneDigits[0] === '+') {
-+    if(phoneDigits === prevPhoneDigits) {
-+			value = e164(phoneDigits, country, metadata)
-+		} else if (phoneDigits[0] === '+') {
-       if (phoneDigits === '+') {
-         value = undefined;
-       } else if (country && (0, _getInternationalPhoneNumberPrefix["default"])(country, metadata).indexOf(phoneDigits) === 0) {
-diff --git a/modules/helpers/phoneInputHelpers.js b/modules/helpers/phoneInputHelpers.js
-index 75e8463f6b5d32c560d1dec2776671bee2af1d07..99af2904807cc3c23aea566bbeebda2a5bc9afa4 100644
---- a/modules/helpers/phoneInputHelpers.js
-+++ b/modules/helpers/phoneInputHelpers.js
-@@ -551,7 +551,9 @@ export function onPhoneDigitsChange(phoneDigits, _ref5) {
-   // Generate the new `value` property.
-   var value;
-   if (phoneDigits) {
--    if (phoneDigits[0] === '+') {
-+    if(phoneDigits === prevPhoneDigits) {
-+			value = e164(phoneDigits, country, metadata)
-+		} else if (phoneDigits[0] === '+') {
-       if (phoneDigits === '+') {
-         value = undefined;
-       } else if (country && getInternationalPhoneNumberPrefix(country, metadata).indexOf(phoneDigits) === 0) {
-diff --git a/react-styleguidist/project/source/helpers/phoneInputHelpers.js b/react-styleguidist/project/source/helpers/phoneInputHelpers.js
-index b844ef0fd183fe4f45e436bdb2382fc2987dcef2..8960834900e59a57e130521fd369e82fe05f5090 100644
---- a/react-styleguidist/project/source/helpers/phoneInputHelpers.js
-+++ b/react-styleguidist/project/source/helpers/phoneInputHelpers.js
-@@ -505,7 +505,9 @@ export function onPhoneDigitsChange(phoneDigits, {
- 	// Generate the new `value` property.
- 	let value
- 	if (phoneDigits) {
--		if (phoneDigits[0] === '+') {
-+		if(phoneDigits === prevPhoneDigits) {
-+			value = e164(phoneDigits, country, metadata)
-+		} else if (phoneDigits[0] === '+') {
- 			if (phoneDigits === '+') {
- 				value = undefined
- 			} else if (country && getInternationalPhoneNumberPrefix(country, metadata).indexOf(phoneDigits) !== 0) {

.yarnrc.yml

@@ -6,4 +6,4 @@ enableInlineHunks: true
 
 nodeLinker: node-modules
 
-yarnPath: .yarn/releases/yarn-4.9.2.cjs
+yarnPath: .yarn/releases/yarn-4.4.0.cjs

CLAUDE.md

@@ -1,201 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-Twenty is an open-source CRM built with modern technologies in a monorepo structure. The codebase is organized as an Nx workspace with multiple packages.
-
-## Key Commands
-
-### Development
-```bash
-# Start development environment (frontend + backend + worker)
-yarn start
-
-# Individual package development
-npx nx start twenty-front     # Start frontend dev server
-npx nx start twenty-server    # Start backend server
-npx nx run twenty-server:worker  # Start background worker
-```
-
-### Testing
-```bash
-# Preferred: run a single test file (fast)
-npx jest path/to/test.test.ts --config=packages/PROJECT/jest.config.mjs
-
-# Run all tests for a package
-npx nx test twenty-front      # Frontend unit tests
-npx nx test twenty-server     # Backend unit tests
-npx nx run twenty-server:test:integration:with-db-reset  # Integration tests with DB reset
-
-# Storybook
-npx nx storybook:build twenty-front
-npx nx storybook:test twenty-front
-
-# When testing the UI end to end, click on "Continue with Email" and use the prefilled credentials.
-```
-
-### Code Quality
-```bash
-# Linting (diff with main - fastest, always prefer this)
-npx nx lint:diff-with-main twenty-front
-npx nx lint:diff-with-main twenty-server
-npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix
-
-# Linting (full project - slower, use only when needed)
-npx nx lint twenty-front
-npx nx lint twenty-server
-
-# Type checking
-npx nx typecheck twenty-front
-npx nx typecheck twenty-server
-
-# Format code
-npx nx fmt twenty-front
-npx nx fmt twenty-server
-```
-
-### Build
-```bash
-# Build packages (twenty-shared must be built first)
-npx nx build twenty-shared
-npx nx build twenty-front
-npx nx build twenty-server
-```
-
-### Database Operations
-```bash
-# Database management
-npx nx database:reset twenty-server         # Reset database
-npx nx run twenty-server:database:init:prod # Initialize database
-npx nx run twenty-server:database:migrate:prod # Run migrations
-
-# Generate migration (replace [name] with kebab-case descriptive name)
-npx nx run twenty-server:typeorm migration:generate src/database/typeorm/core/migrations/common/[name] -d src/database/typeorm/core/core.datasource.ts
-
-# Sync metadata
-npx nx run twenty-server:command workspace:sync-metadata
-```
-
-### GraphQL
-```bash
-# Generate GraphQL types (run after schema changes)
-npx nx run twenty-front:graphql:generate
-npx nx run twenty-front:graphql:generate --configuration=metadata
-```
-
-## Architecture Overview
-
-### Tech Stack
-- **Frontend**: React 18, TypeScript, Recoil (state management), Emotion (styling), Vite
-- **Backend**: NestJS, TypeORM, PostgreSQL, Redis, GraphQL (with GraphQL Yoga)
-- **Monorepo**: Nx workspace managed with Yarn 4
-
-### Package Structure
-```
-packages/
-├── twenty-front/          # React frontend application
-├── twenty-server/         # NestJS backend API
-├── twenty-ui/             # Shared UI components library
-├── twenty-shared/         # Common types and utilities
-├── twenty-emails/         # Email templates with React Email
-├── twenty-website/        # Next.js documentation website
-├── twenty-zapier/         # Zapier integration
-└── twenty-e2e-testing/    # Playwright E2E tests
-```
-
-### Key Development Principles
-- **Functional components only** (no class components)
-- **Named exports only** (no default exports)
-- **Types over interfaces** (except when extending third-party interfaces)
-- **String literals over enums** (except for GraphQL enums)
-- **No 'any' type allowed** — strict TypeScript enforced
-- **Event handlers preferred over useEffect** for state updates
-- **Props down, events up** — unidirectional data flow
-- **Composition over inheritance**
-- **No abbreviations** in variable names (`user` not `u`, `fieldMetadata` not `fm`)
-
-### Naming Conventions
-- **Variables/functions**: camelCase
-- **Constants**: SCREAMING_SNAKE_CASE
-- **Types/Classes**: PascalCase (suffix component props with `Props`, e.g. `ButtonProps`)
-- **Files/directories**: kebab-case with descriptive suffixes (`.component.tsx`, `.service.ts`, `.entity.ts`, `.dto.ts`, `.module.ts`)
-- **TypeScript generics**: descriptive names (`TData` not `T`)
-
-### File Structure
-- Components under 300 lines, services under 500 lines
-- Components in their own directories with tests and stories
-- Use `index.ts` barrel exports for clean imports
-- Import order: external libraries first, then internal (`@/`), then relative
-
-### Comments
-- Use short-form comments (`//`), not JSDoc blocks
-- Explain WHY (business logic), not WHAT
-- Do not comment obvious code
-- Multi-line comments use multiple `//` lines, not `/** */`
-
-### State Management
-- **Recoil** for global state: atoms for primitive state, selectors for derived state, atom families for dynamic collections
-- Component-specific state with React hooks (`useState`, `useReducer` for complex logic)
-- GraphQL cache managed by Apollo Client
-- Use functional state updates: `setState(prev => prev + 1)`
-
-### Backend Architecture
-- **NestJS modules** for feature organization
-- **TypeORM** for database ORM with PostgreSQL
-- **GraphQL** API with code-first approach
-- **Redis** for caching and session management
-- **BullMQ** for background job processing
-
-### Database & Migrations
-- **PostgreSQL** as primary database
-- **Redis** for caching and sessions
-- **ClickHouse** for analytics (when enabled)
-- Always generate migrations when changing entity files
-- Migration names must be kebab-case (e.g. `add-agent-turn-evaluation`)
-- Include both `up` and `down` logic in migrations
-- Never delete or rewrite committed migrations
-
-### Utility Helpers
-Use existing helpers from `twenty-shared` instead of manual type guards:
-- `isDefined()`, `isNonEmptyString()`, `isNonEmptyArray()`
-
-## Development Workflow
-
-IMPORTANT: Use Context7 for code generation, setup or configuration steps, or library/API documentation. Automatically use the Context7 MCP tools to resolve library IDs and get library docs without waiting for explicit requests.
-
-### Before Making Changes
-1. Always run linting (`lint:diff-with-main`) and type checking after code changes
-2. Test changes with relevant test suites (prefer single-file test runs)
-3. Ensure database migrations are generated for entity changes
-4. Check that GraphQL schema changes are backward compatible
-5. Run `graphql:generate` after any GraphQL schema changes
-
-### Code Style Notes
-- Use **Emotion** for styling with styled-components pattern
-- Follow **Nx** workspace conventions for imports
-- Use **Lingui** for internationalization
-- Apply security first, then formatting (sanitize before format)
-
-### Testing Strategy
-- **Test behavior, not implementation** — focus on user perspective
-- **Test pyramid**: 70% unit, 20% integration, 10% E2E
-- Query by user-visible elements (text, roles, labels) over test IDs
-- Use `@testing-library/user-event` for realistic interactions
-- Descriptive test names: "should [behavior] when [condition]"
-- Clear mocks between tests with `jest.clearAllMocks()`
-
-## CI Environment (GitHub Actions)
-
-When running in CI, the dev environment is **not** pre-configured. Dependencies are installed but builds, env files, and databases are not set up.
-
-- **Before running tests, builds, lint, type checks, or DB operations**, run: `bash packages/twenty-utils/setup-dev-env.sh`
-- **Skip the setup script** for tasks that only read code — architecture questions, code review, documentation, etc.
-- The script is idempotent and safe to run multiple times.
-
-## Important Files
-- `nx.json` - Nx workspace configuration with task definitions
-- `tsconfig.base.json` - Base TypeScript configuration
-- `package.json` - Root package with workspace definitions
-- `.cursor/rules/` - Detailed development guidelines and best practices

Makefile

@@ -0,0 +1,20 @@
+postgres-on-docker:
+	docker run -d \
+	--name twenty_pg \
+	-e PGUSER_SUPERUSER=postgres \
+	-e PGPASSWORD_SUPERUSER=postgres \
+	-e ALLOW_NOSSL=true \
+	-v twenty_db_data:/home/postgres/pgdata \
+	-p 5432:5432 \
+	twentycrm/twenty-postgres-spilo:latest
+	@echo "Waiting for PostgreSQL to be ready..."
+	@until docker exec twenty_pg psql -U postgres -d postgres \
+		-c 'SELECT pg_is_in_recovery();' 2>/dev/null | grep -q 'f'; do \
+		sleep 1; \
+	done
+	docker exec twenty_pg psql -U postgres -d postgres \
+		-c "CREATE DATABASE \"default\" WITH OWNER postgres;" \
+		-c "CREATE DATABASE \"test\" WITH OWNER postgres;"
+
+redis-on-docker:
+	docker run -d --name twenty_redis -p 6379:6379 redis/redis-stack-server:latest

README.md

@@ -1,32 +1,34 @@
+
+<br>
 <p align="center">
   <a href="https://www.twenty.com">
     <img src="./packages/twenty-website/public/images/core/logo.svg" width="100px" alt="Twenty logo" />
   </a>
 </p>
 
-<h2 align="center" >The #1 Open-Source CRM </h2>
+<h2 align="center" >The #1 Open-Source CRM </h3>
 
-<p align="center"><a href="https://twenty.com">🌐 Website</a> · <a href="https://docs.twenty.com">📚 Documentation</a> · <a href="https://github.com/orgs/twentyhq/projects/1"><img src="./packages/twenty-website/public/images/readme/planner-icon.svg" width="12" height="12"/> Roadmap </a> · <a href="https://discord.gg/cx5n4Jzs57"><img src="./packages/twenty-website/public/images/readme/discord-icon.svg" width="12" height="12"/> Discord</a> · <a href="https://www.figma.com/file/xt8O9mFeLl46C5InWwoMrN/Twenty"><img src="./packages/twenty-website/public/images/readme/figma-icon.png"  width="12" height="12"/>  Figma</a></p>
+<p align="center"><a href="https://twenty.com">🌐 Website</a> · <a href="https://twenty.com/developers">📚 Documentation</a> · <a href="https://github.com/orgs/twentyhq/projects/1"><img src="./packages/twenty-website/public/images/readme/planner-icon.svg" width="12" height="12"/> Roadmap </a> · <a href="https://discord.gg/cx5n4Jzs57"><img src="./packages/twenty-website/public/images/readme/discord-icon.svg" width="12" height="12"/> Discord</a> · <a href="https://www.figma.com/file/xt8O9mFeLl46C5InWwoMrN/Twenty"><img src="./packages/twenty-website/public/images/readme/figma-icon.png"  width="12" height="12"/>  Figma</a><p>
 <br />
 
 
 <p align="center">
   <a href="https://www.twenty.com">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/github-cover-dark.png" />
-      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/github-cover-light.png" />
-      <img src="./packages/twenty-website/public/images/readme/github-cover-light.png" alt="Cover" />
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/preview-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/preview-light.png">
+      <img src="./packages/twenty-docs/static/img/preview-light.png" alt="Companies view" />
     </picture>
   </a>
 </p>
 
-<br />
+<br>
 
-# Installation
+# Installation 
 
-See:
-🚀 [Self-hosting](https://docs.twenty.com/developers/self-hosting/docker-compose)
-🖥️ [Local Setup](https://docs.twenty.com/developers/local-setup)
+See:  
+🚀 [Self-hosting](https://twenty.com/developers/section/self-hosting)  
+🖥️ [Local Setup](https://twenty.com/developers/local-setup)  
 
 # Does the world need another CRM?
 
@@ -38,98 +40,123 @@ We built Twenty for three reasons:
 
 **We believe in Open-source and community.** Hundreds of developers are already building Twenty together. Once we have plugin capabilities, a whole ecosystem will grow around it.
 
-<br />
+<br>
 
 # What You Can Do With Twenty
+We're currently developing Twenty's beta version.  
 
-Please feel free to flag any specific needs you have by creating an issue.
+Please feel free to flag any specific needs you have by creating an issue.   
 
 Below are a few features we have implemented to date:
 
-+ [Personalize layouts with filters, sort, group by, kanban and table views](#personalize-layouts-with-filters-sort-group-by-kanban-and-table-views)
-+ [Customize your objects and fields](#customize-your-objects-and-fields)
-+ [Create and manage permissions with custom roles](#create-and-manage-permissions-with-custom-roles)
-+ [Automate workflow with triggers and actions](#automate-workflow-with-triggers-and-actions)
-+ [Emails, calendar events, files, and more](#emails-calendar-events-files-and-more)
++ [Add, filter, sort, edit, and track customers](#add-filter-sort-edit-and-track-customers)
++ [Create one or several opportunities for each company](#create-one-or-several-opportunities-for-each-company)
++ [See rich notes tasks displayed in a timeline](#see-rich-notes-tasks-displayed-in-a-timeline)
++ [Create tasks on records](#create-tasks-on-records)
++ [Navigate quickly through the app using keyboard shortcuts and search](#navigate-quickly-through-the-app-using-keyboard-shortcuts-and-search)
 
 
-## Personalize layouts with filters, sort, group by, kanban and table views
+## Add, filter, sort, edit, and track customers:
 
 <p align="center">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/views-dark.png" />
-      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/views-light.png" />
-      <img src="./packages/twenty-website/public/images/readme/views-light.png" alt="Companies Kanban Views" />
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/index-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/index-light.png">
+      <img src="./packages/twenty-docs/static/img/visualise-customer-light.png" alt="Companies view" />
     </picture>
 </p>
 
-## Customize your objects and fields
+## Create one or several opportunities for each company:
 
 <p align="center">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/data-model-dark.png" />
-      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/data-model-light.png" />
-      <img src="./packages/twenty-website/public/images/readme/data-model-light.png" alt="Setting Custom Objects" />
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/kanban-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/kanban-light.png">
+      <img src="./packages/twenty-docs/static/img/follow-your-deals-light.png" alt="Companies view" />
     </picture>
 </p>
 
-## Create and manage permissions with custom roles
+## Track deals effortlessly with the email integration:
 
 <p align="center">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/permissions-dark.png" />
-      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/permissions-light.png" />
-      <img src="./packages/twenty-website/public/images/readme/permissions-light.png" alt="Permissions" />
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/emails-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/emails-light.png">
+      <img src="./packages/twenty-docs/static/img/rich-notes-light.png" alt="Companies view" />
     </picture>
 </p>
 
-## Automate workflow with triggers and actions
+## Tailor your data model to meet business needs:
 
 <p align="center">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/workflows-dark.png" />
-      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/workflows-light.png" />
-      <img src="./packages/twenty-website/public/images/readme/workflows-light.png" alt="Workflows" />
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/data-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/data-light.png">
+      <img src="./packages/twenty-docs/static/img/rich-notes-light.png" alt="Companies view" />
     </picture>
 </p>
 
-## Emails, calendar events, files, and more
+## See rich notes displayed in a timeline:
 
 <p align="center">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/plus-other-features-dark.png" />
-      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-website/public/images/readme/plus-other-features-light.png" />
-      <img src="./packages/twenty-website/public/images/readme/plus-other-features-light.png" alt="Other Features" />
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/notes-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/notes-light.png">
+      <img src="./packages/twenty-docs/static/img/rich-notes-light.png" alt="Companies view" />
     </picture>
 </p>
 
-<br />
+## Create tasks on records
+
+<p align="center">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/tasks-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/tasks-light.png">
+      <img src="./packages/twenty-docs/static/img/create-tasks-light.png" alt="Companies view" />
+    </picture>
+</p>
+
+## Navigate quickly through the app using keyboard shortcuts and search:
+
+<p align="center">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/keyboard-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/keyboard-light.png">
+      <img src="./packages/twenty-docs/static/img/shortcut-navigation-light.png" alt="Companies view" />
+    </picture>
+</p>
+
+## Connect your CRM to all your tools through our APIs and Webhooks.
+
+<p align="center">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/api-dark.png">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/v0.12.0/packages/twenty-docs/static/img/api-light.png">
+      <img src="./packages/twenty-docs/static/img/shortcut-navigation-light.png" alt="Companies view" />
+    </picture>
+</p>
+
+
+<br>
 
 # Stack
 - [TypeScript](https://www.typescriptlang.org/)
 - [Nx](https://nx.dev/)
 - [NestJS](https://nestjs.com/), with [BullMQ](https://bullmq.io/), [PostgreSQL](https://www.postgresql.org/), [Redis](https://redis.io/)
-- [React](https://reactjs.org/), with [Recoil](https://recoiljs.org/), [Emotion](https://emotion.sh/) and [Lingui](https://lingui.dev/)
-
-
-
-# Thanks
-
-<p align="center">
-  <a href="https://www.chromatic.com/"><img src="./packages/twenty-website/public/images/readme/chromatic.png" height="30" alt="Chromatic" /></a>
-  <a href="https://greptile.com"><img src="./packages/twenty-website/public/images/readme/greptile.png" height="30" alt="Greptile" /></a>
-  <a href="https://sentry.io/"><img src="./packages/twenty-website/public/images/readme/sentry.png" height="30" alt="Sentry" /></a>
-  <a href="https://crowdin.com/"><img src="./packages/twenty-website/public/images/readme/crowdin.png" height="30" alt="Crowdin" /></a>
-</p>
-
-  Thanks to these amazing services that we use and recommend for UI testing (Chromatic), code review (Greptile), catching bugs (Sentry) and translating (Crowdin).
+- [React](https://reactjs.org/), with [Recoil](https://recoiljs.org/) and [Emotion](https://emotion.sh/)
+- [Greptile](https://greptile.com) for code reviews.
+- [Lingui](https://lingui.dev/) and [Crowdin](https://twenty.crowdin.com/twenty) for translations.
 
 
 # Join the Community
 
 - Star the repo
 - Subscribe to releases (watch -> custom -> releases)
-- Follow us on [Twitter](https://twitter.com/twentycrm) or [LinkedIn](https://www.linkedin.com/company/twenty/)
+- Follow us on [Twitter](https://twitter.com/twentycrm) or [LinkedIn](https://www.linkedin.com/company/twenty/) 
 - Join our [Discord](https://discord.gg/cx5n4Jzs57)
-- Improve translations on [Crowdin](https://twenty.crowdin.com/twenty)
-- [Contributions](https://github.com/twentyhq/twenty/contribute) are, of course, most welcome!
+- Improve translations on [Crowdin](https://twenty.crowdin.com/twenty) 
+- [Contributions](https://github.com/twentyhq/twenty/contribute) are, of course, most welcome! 
+
+
+
+

crowdin.yml

@@ -0,0 +1,31 @@
+#
+# Basic Crowdin CLI configuration
+# See https://crowdin.github.io/crowdin-cli/configuration for more information
+# See https://support.crowdin.com/developer/configuration-file/ for all available options
+#
+
+#
+# Defines whether to preserve the original directory structure in the Crowdin project
+# Recommended to set to true
+#
+"preserve_hierarchy": true
+
+#
+# Files configuration.
+# See https://support.crowdin.com/developer/configuration-file/ for all available options
+#
+files: [
+  {
+    #
+    # Source files filter
+    # e.g. "/resources/en/*.json"
+    #
+    "source": "**/en.po",
+
+    #
+    # Translation files filter
+    # e.g. "/resources/%two_letters_code%/%original_file_name%"
+    #
+    "translation": "%original_path%/%locale%.po",
+  }
+]

eslint.config.mjs

@@ -1,222 +0,0 @@
-import js from '@eslint/js';
-import nxPlugin from '@nx/eslint-plugin';
-import typescriptEslint from '@typescript-eslint/eslint-plugin';
-import typescriptParser from '@typescript-eslint/parser';
-import importPlugin from 'eslint-plugin-import';
-import linguiPlugin from 'eslint-plugin-lingui';
-import * as mdxPlugin from 'eslint-plugin-mdx';
-import preferArrowPlugin from 'eslint-plugin-prefer-arrow';
-import prettierPlugin from 'eslint-plugin-prettier';
-import unicornPlugin from 'eslint-plugin-unicorn';
-import unusedImportsPlugin from 'eslint-plugin-unused-imports';
-import jsoncParser from 'jsonc-eslint-parser';
-
-const twentyRules = await nxPlugin.loadWorkspaceRules(
-  'packages/twenty-eslint-rules',
-);
-
-export default [
-  // Base JavaScript configuration
-  js.configs.recommended,
-
-  // Lingui recommended rules
-  linguiPlugin.configs['flat/recommended'],
-
-  // Global ignores
-  {
-    ignores: ['**/node_modules/**'],
-  },
-
-  // Base configuration for all files
-  {
-    files: ['**/*.{js,jsx,ts,tsx}'],
-    plugins: {
-      prettier: prettierPlugin,
-      lingui: linguiPlugin,
-      '@nx': nxPlugin,
-      'prefer-arrow': preferArrowPlugin,
-      import: importPlugin,
-      'unused-imports': unusedImportsPlugin,
-      unicorn: unicornPlugin,
-    },
-    rules: {
-      // General rules
-      'func-style': ['error', 'declaration', { allowArrowFunctions: true }],
-      'no-console': [
-        'warn',
-        { allow: ['group', 'groupCollapsed', 'groupEnd'] },
-      ],
-      'no-control-regex': 0,
-      'no-debugger': 'error',
-      'no-duplicate-imports': 'error',
-      'no-undef': 'off',
-      'no-unused-vars': 'off',
-
-      // Nx rules
-      '@nx/enforce-module-boundaries': [
-        'error',
-        {
-          enforceBuildableLibDependency: true,
-          allow: [],
-          depConstraints: [
-            {
-              sourceTag: 'scope:apps',
-              onlyDependOnLibsWithTags: ['scope:apps', 'scope:sdk'],
-            },
-            {
-              sourceTag: 'scope:sdk',
-              onlyDependOnLibsWithTags: ['scope:sdk', 'scope:shared'],
-            },
-            {
-              sourceTag: 'scope:create-app',
-              onlyDependOnLibsWithTags: ['scope:create-app', 'scope:shared'],
-            },
-            {
-              sourceTag: 'scope:shared',
-              onlyDependOnLibsWithTags: ['scope:shared'],
-            },
-            {
-              sourceTag: 'scope:backend',
-              onlyDependOnLibsWithTags: ['scope:shared', 'scope:backend'],
-            },
-            {
-              sourceTag: 'scope:frontend',
-              onlyDependOnLibsWithTags: ['scope:shared', 'scope:frontend'],
-            },
-          ],
-        },
-      ],
-
-      // Import rules
-      'import/no-relative-packages': 'error',
-      'import/no-useless-path-segments': 'error',
-      'import/no-duplicates': ['error', { considerQueryString: true }],
-
-      // Prefer arrow functions
-      'prefer-arrow/prefer-arrow-functions': [
-        'error',
-        {
-          disallowPrototype: true,
-          singleReturnOnly: false,
-          classPropertiesAllowed: false,
-        },
-      ],
-
-      // Unused imports
-      'unused-imports/no-unused-imports': 'warn',
-      'unused-imports/no-unused-vars': [
-        'warn',
-        {
-          vars: 'all',
-          varsIgnorePattern: '^_',
-          args: 'after-used',
-          argsIgnorePattern: '^_',
-        },
-      ],
-    },
-  },
-
-  // TypeScript specific configuration
-  {
-    files: ['**/*.{ts,tsx}'],
-    languageOptions: {
-      parser: typescriptParser,
-      parserOptions: {
-        ecmaFeatures: {
-          jsx: true,
-        },
-      },
-    },
-    plugins: {
-      '@typescript-eslint': typescriptEslint,
-    },
-    rules: {
-      // TypeScript rules
-      'no-redeclare': 'off', // Turn off base rule for TypeScript
-      '@typescript-eslint/no-redeclare': 'error', // Use TypeScript-aware version
-      '@typescript-eslint/ban-ts-comment': 'error',
-      '@typescript-eslint/consistent-type-imports': [
-        'error',
-        {
-          prefer: 'type-imports',
-          fixStyle: 'inline-type-imports',
-        },
-      ],
-      '@typescript-eslint/explicit-function-return-type': 'off',
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/interface-name-prefix': 'off',
-      '@typescript-eslint/no-empty-object-type': [
-        'error',
-        {
-          allowInterfaces: 'with-single-extends',
-        },
-      ],
-      '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/no-empty-function': 'off',
-      '@typescript-eslint/no-unused-vars': 'off',
-    },
-  },
-
-  // JavaScript specific configuration
-  {
-    files: ['*.{js,jsx}'],
-    rules: {
-      // JavaScript-specific rules if needed
-    },
-  },
-
-  // Test files
-  {
-    files: [
-      '*.spec.@(ts|tsx|js|jsx)',
-      '*.integration-spec.@(ts|tsx|js|jsx)',
-      '*.test.@(ts|tsx|js|jsx)',
-    ],
-    languageOptions: {
-      globals: {
-        jest: true,
-        describe: true,
-        it: true,
-        expect: true,
-        beforeEach: true,
-        afterEach: true,
-        beforeAll: true,
-        afterAll: true,
-      },
-    },
-    rules: {
-      '@typescript-eslint/no-non-null-assertion': 'off',
-    },
-  },
-
-  // JSON files
-  {
-    files: ['**/*.json'],
-    languageOptions: {
-      parser: jsoncParser,
-    },
-  },
-
-  // MDX files
-  {
-    ...mdxPlugin.flat,
-    plugins: {
-      ...mdxPlugin.flat.plugins,
-      '@nx': nxPlugin,
-      twenty: { rules: twentyRules },
-    },
-  },
-  mdxPlugin.flatCodeBlocks,
-  {
-    files: ['**/*.mdx'],
-    rules: {
-      'no-unused-vars': 'off',
-      'unused-imports/no-unused-imports': 'off',
-      'unused-imports/no-unused-vars': 'off',
-      // Enforce JSX tags on separate lines to prevent Crowdin translation issues
-      'twenty/mdx-component-newlines': 'error',
-      // Disallow angle bracket placeholders to prevent Crowdin translation errors
-      'twenty/no-angle-bracket-placeholders': 'error',
-    },
-  },
-];

jest.config.js

@@ -0,0 +1,5 @@
+import { getJestProjects } from '@nx/jest';
+
+export default {
+  projects: getJestProjects(),
+};

jest.preset.js

@@ -1,9 +1,3 @@
 const nxPreset = require('@nx/jest/preset').default;
 
-module.exports = {
-  ...nxPreset,
-  // Override the new testEnvironmentOptions added in @nx/jest 22.3.3
-  // which breaks Lingui's module resolution
-  testEnvironmentOptions: {},
-};
-
+module.exports = { ...nxPreset };

nx

@@ -0,0 +1,5 @@
+#!/bin/bash
+command -v node >/dev/null 2>&1 || { echo >&2 "Nx requires NodeJS to be available. To install NodeJS and NPM, see: https://nodejs.org/en/download/ ."; exit 1; }
+command -v npm >/dev/null 2>&1 || { echo >&2 "Nx requires npm to be available. To install NodeJS and NPM, see: https://nodejs.org/en/download/ ."; exit 1; }
+path_to_root=$(dirname $BASH_SOURCE)
+node $path_to_root/.nx/nxw.js $@

nx.json

@@ -1,8 +1,4 @@
 {
-  "workspaceLayout": {
-    "appsDir": "packages",
-    "libsDir": "packages"
-  },
   "namedInputs": {
     "default": ["{projectRoot}/**/*"],
     "excludeStories": [
@@ -36,7 +32,7 @@
       "dependsOn": ["^build"]
     },
     "start": {
-      "cache": false,
+      "cache": true,
       "dependsOn": ["^build"]
     },
     "lint": {
@@ -44,33 +40,17 @@
       "cache": true,
       "outputs": ["{options.outputFile}"],
       "options": {
-        "eslintConfig": "{projectRoot}/eslint.config.mjs",
+        "eslintConfig": "{projectRoot}/.eslintrc.cjs",
         "cache": true,
-        "cacheLocation": "{workspaceRoot}/.cache/eslint"
+        "cacheLocation": "{workspaceRoot}/.cache/eslint",
+        "ignorePath": "{workspaceRoot}/.gitignore"
       },
       "configurations": {
-        "ci": {
-          "cacheStrategy": "content"
-        },
-        "fix": {
-          "fix": true
-        }
+        "ci": { "cacheStrategy": "content" },
+        "fix": { "fix": true }
       },
       "dependsOn": ["^build"]
     },
-    "lint:diff-with-main": {
-      "executor": "nx:run-commands",
-      "cache": false,
-      "options": {
-        "command": "git diff --name-only --diff-filter=d main | grep -E '{args.pattern}' | grep '^{projectRoot}/' | xargs sh -c 'if [ $# -gt 0 ]; then npx eslint --config {projectRoot}/eslint.config.mjs \"$@\"; fi' _",
-        "pattern": "\\.(ts|tsx|js|jsx)$"
-      },
-      "configurations": {
-        "fix": {
-          "command": "git diff --name-only --diff-filter=d main | grep -E '{args.pattern}' | grep '^{projectRoot}/' | xargs sh -c 'if [ $# -gt 0 ]; then npx eslint --config {projectRoot}/eslint.config.mjs --fix \"$@\"; fi' _"
-        }
-      }
-    },
     "fmt": {
       "executor": "nx:run-commands",
       "cache": true,
@@ -83,12 +63,8 @@
         "write": false
       },
       "configurations": {
-        "ci": {
-          "cacheStrategy": "content"
-        },
-        "fix": {
-          "write": true
-        }
+        "ci": { "cacheStrategy": "content" },
+        "fix": { "write": true }
       },
       "dependsOn": ["^build"]
     },
@@ -97,12 +73,10 @@
       "cache": true,
       "options": {
         "cwd": "{projectRoot}",
-        "command": "tsgo -p tsconfig.json"
+        "command": "tsc -b tsconfig.json --incremental"
       },
       "configurations": {
-        "watch": {
-          "command": "tsgo -p tsconfig.json --watch"
-        }
+        "watch": { "watch": true }
       },
       "dependsOn": ["^build"]
     },
@@ -117,7 +91,7 @@
       ],
       "outputs": ["{projectRoot}/coverage"],
       "options": {
-        "jestConfig": "{projectRoot}/jest.config.mjs",
+        "jestConfig": "{projectRoot}/jest.config.ts",
         "coverage": true,
         "coverageReporters": ["text-summary"],
         "cacheDirectory": "../../.cache/jest/{projectRoot}"
@@ -127,12 +101,8 @@
           "ci": true,
           "maxWorkers": 3
         },
-        "coverage": {
-          "coverageReporters": ["lcov", "text"]
-        },
-        "watch": {
-          "watch": true
-        }
+        "coverage": { "coverageReporters": ["lcov", "text"] },
+        "watch": { "watch": true }
       }
     },
     "test:e2e": {
@@ -146,7 +116,7 @@
       "outputs": ["{projectRoot}/{options.output-dir}"],
       "options": {
         "cwd": "{projectRoot}",
-        "command": "NODE_OPTIONS='--max-old-space-size=10240' VITE_DISABLE_TYPESCRIPT_CHECKER=true storybook build --test",
+        "command": "VITE_DISABLE_TYPESCRIPT_CHECKER=true VITE_DISABLE_ESLINT_CHECKER=true storybook build --test",
         "output-dir": "storybook-static",
         "config-dir": ".storybook"
       },
@@ -181,8 +151,15 @@
       "outputs": ["{projectRoot}/coverage/storybook"],
       "options": {
         "cwd": "{projectRoot}",
-        "command": "vitest run --coverage --shard={args.shard}",
-        "shard": "1/1"
+        "commands": [
+          "test-storybook --url http://localhost:{args.port} --maxWorkers=3 --coverage --coverageDirectory={args.coverageDir} --shard={args.shard}",
+          "nx storybook:coverage {projectName} --coverageDir={args.coverageDir} --checkCoverage={args.checkCoverage}"
+        ],
+        "shard": "1/1",
+        "parallel": false,
+        "coverageDir": "coverage/storybook",
+        "port": 6006,
+        "checkCoverage": true
       }
     },
     "storybook:test:no-coverage": {
@@ -190,8 +167,10 @@
       "inputs": ["^default", "excludeTests"],
       "options": {
         "cwd": "{projectRoot}",
-        "command": "vitest run --shard={args.shard}",
-        "shard": "1/1"
+        "commands": [
+          "test-storybook --url http://localhost:{args.port} --maxWorkers=2"
+        ],
+        "port": 6006
       }
     },
     "storybook:coverage": {
@@ -213,9 +192,18 @@
         "checkCoverage": true
       },
       "configurations": {
-        "text": {
-          "reporter": "text"
-        }
+        "text": { "reporter": "text" }
+      }
+    },
+    "storybook:serve-and-test:static": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": [
+          "npx concurrently --kill-others --success=first -n SB,TEST 'nx storybook:serve:static {projectName} --port={args.port}' 'npx wait-on tcp:{args.port} && nx storybook:test {projectName} --shard={args.shard} --checkCoverage={args.checkCoverage} --port={args.port} --configuration={args.scope}'"
+        ],
+        "shard": "1/1",
+        "checkCoverage": true,
+        "port": 6006
       }
     },
     "chromatic": {
@@ -227,7 +215,7 @@
             "command": "nx storybook:build {projectName}",
             "forwardAllArgs": false
           },
-          "chromatic --storybook-build-dir=storybook-static {args.ci}"
+          "cross-var chromatic --project-token=$CHROMATIC_PROJECT_TOKEN --storybook-build-dir=storybook-static {args.ci}"
         ],
         "parallel": false
       },
@@ -258,22 +246,22 @@
       "cache": true,
       "inputs": [
         "default",
-        "{workspaceRoot}/eslint.config.mjs",
-        "{workspaceRoot}/packages/twenty-eslint-rules/**/*"
+        "{workspaceRoot}/.eslintrc.js",
+        "{workspaceRoot}/tools/eslint-rules/**/*"
       ]
     },
+    "@nx/vite:test": {
+      "cache": true,
+      "inputs": ["default", "^default"]
+    },
     "@nx/vite:build": {
       "cache": true,
       "dependsOn": ["^build"],
       "inputs": ["default", "^default"]
-    },
-    "@nx/vitest:test": {
-      "cache": true,
-      "inputs": ["default", "^default"]
     }
   },
   "installation": {
-    "version": "22.3.3"
+    "version": "18.3.3"
   },
   "generators": {
     "@nx/react": {
@@ -306,8 +294,5 @@
     }
   },
   "useInferencePlugins": false,
-  "defaultBase": "main",
-  "tui": {
-    "enabled": false
-  }
+  "defaultBase": "main"
 }

package.json

@@ -1,31 +1,123 @@
 {
   "private": true,
   "dependencies": {
+    "@air/react-drag-to-select": "^5.0.8",
     "@apollo/client": "^3.7.17",
+    "@apollo/server": "^4.7.3",
+    "@aws-sdk/client-lambda": "^3.614.0",
+    "@aws-sdk/client-s3": "^3.363.0",
+    "@aws-sdk/client-sts": "^3.744.0",
+    "@aws-sdk/credential-providers": "^3.363.0",
+    "@blocknote/mantine": "^0.22.0",
+    "@blocknote/react": "^0.22.0",
+    "@blocknote/server-util": "0.17.1",
+    "@codesandbox/sandpack-react": "^2.13.5",
+    "@dagrejs/dagre": "^1.1.2",
     "@emotion/react": "^11.11.1",
     "@emotion/styled": "^11.11.0",
+    "@envelop/on-resolve": "^4.1.0",
     "@floating-ui/react": "^0.24.3",
+    "@google-cloud/local-auth": "2.1.0",
+    "@graphiql/plugin-explorer": "^1.0.2",
+    "@graphql-tools/schema": "^10.0.0",
+    "@hello-pangea/dnd": "^16.2.0",
+    "@hookform/resolvers": "^3.1.1",
+    "@jsdevtools/rehype-toc": "^3.0.2",
     "@linaria/core": "^6.2.0",
     "@linaria/react": "^6.2.1",
-    "@radix-ui/colors": "^3.0.0",
+    "@mdx-js/react": "^3.0.0",
+    "@microsoft/microsoft-graph-client": "^3.0.7",
+    "@nestjs/apollo": "^11.0.5",
+    "@nestjs/axios": "^3.0.1",
+    "@nestjs/cli": "^9.0.0",
+    "@nestjs/common": "^9.0.0",
+    "@nestjs/config": "^2.3.2",
+    "@nestjs/core": "^9.0.0",
+    "@nestjs/event-emitter": "^2.0.3",
+    "@nestjs/jwt": "^10.0.3",
+    "@nestjs/passport": "^9.0.3",
+    "@nestjs/platform-express": "^9.0.0",
+    "@nestjs/serve-static": "^4.0.1",
+    "@nestjs/terminus": "^11.0.0",
+    "@nestjs/typeorm": "^10.0.0",
+    "@nx/eslint-plugin": "^17.2.8",
+    "@octokit/graphql": "^7.0.2",
+    "@ptc-org/nestjs-query-core": "^4.2.0",
+    "@ptc-org/nestjs-query-typeorm": "4.2.1-alpha.2",
+    "@react-email/components": "0.0.32",
+    "@react-email/render": "0.0.17",
+    "@sentry/node": "^8",
+    "@sentry/profiling-node": "^8",
+    "@sentry/react": "^8",
     "@sniptt/guards": "^0.2.0",
+    "@stoplight/elements": "^8.0.5",
+    "@swc/jest": "^0.2.29",
     "@tabler/icons-react": "^3.31.0",
-    "@wyw-in-js/vite": "^0.7.0",
+    "@types/dompurify": "^3.0.5",
+    "@types/facepaint": "^1.2.5",
+    "@types/lodash.camelcase": "^4.3.7",
+    "@types/lodash.chunk": "^4.2.9",
+    "@types/lodash.merge": "^4.6.7",
+    "@types/lodash.pick": "^4.3.7",
+    "@types/nodemailer": "^6.4.14",
+    "@types/passport-microsoft": "^1.0.3",
+    "@wyw-in-js/vite": "^0.5.3",
+    "@xyflow/react": "^12.4.2",
+    "add": "^2.0.6",
+    "addressparser": "^1.0.1",
+    "afterframe": "^1.0.2",
+    "apollo-server-express": "^3.12.0",
+    "apollo-upload-client": "^17.0.0",
     "archiver": "^7.0.1",
+    "axios": "^1.6.2",
+    "bcrypt": "^5.1.1",
+    "better-sqlite3": "^9.2.2",
+    "body-parser": "^1.20.2",
+    "bullmq": "^5.40.0",
+    "bytes": "^3.1.2",
+    "class-transformer": "^0.5.1",
+    "clsx": "^2.1.1",
+    "cron-validate": "^1.4.5",
+    "cross-env": "^7.0.3",
+    "css-loader": "^7.1.2",
     "danger-plugin-todos": "^1.3.1",
+    "dataloader": "^2.2.2",
     "date-fns": "^2.30.0",
     "date-fns-tz": "^2.0.0",
+    "debounce": "^2.0.0",
     "deep-equal": "^2.2.2",
+    "dompurify": "^3.0.11",
+    "dotenv-cli": "^7.2.1",
+    "drizzle-orm": "^0.29.3",
+    "esbuild-plugin-svgr": "^2.1.0",
+    "facepaint": "^1.2.1",
     "file-type": "16.5.4",
     "framer-motion": "^11.18.0",
-    "fuse.js": "^7.1.0",
     "googleapis": "105",
+    "graphiql": "^3.1.1",
+    "graphql": "16.8.0",
+    "graphql-fields": "^2.0.3",
+    "graphql-middleware": "^6.1.35",
+    "graphql-rate-limit": "^3.3.0",
+    "graphql-scalars": "^1.23.0",
+    "graphql-subscriptions": "2.0.0",
+    "graphql-tag": "^2.12.6",
+    "graphql-type-json": "^0.3.2",
+    "graphql-upload": "^13.0.0",
+    "graphql-yoga": "^4.0.4",
     "hex-rgb": "^5.0.0",
-    "immer": "^10.1.1",
+    "iframe-resizer-react": "^1.1.0",
+    "immer": "^10.0.2",
+    "jest-mock-extended": "^3.0.4",
+    "js-cookie": "^3.0.5",
+    "js-levenshtein": "^1.1.6",
+    "json-2-csv": "^5.4.0",
+    "jsonwebtoken": "^9.0.0",
     "libphonenumber-js": "^1.10.26",
     "lodash.camelcase": "^4.3.0",
     "lodash.chunk": "^4.2.0",
     "lodash.compact": "^3.0.1",
+    "lodash.debounce": "^4.0.8",
     "lodash.escaperegexp": "^4.1.2",
     "lodash.groupby": "^4.6.0",
     "lodash.identity": "^3.0.0",
@@ -36,79 +128,137 @@
     "lodash.mapvalues": "^4.6.0",
     "lodash.merge": "^4.6.2",
     "lodash.omit": "^4.5.0",
+    "lodash.pick": "^4.4.0",
     "lodash.pickby": "^4.6.0",
     "lodash.snakecase": "^4.1.1",
     "lodash.upperfirst": "^4.3.1",
+    "luxon": "^3.3.0",
     "microdiff": "^1.3.2",
+    "moize": "^6.1.6",
+    "nest-commander": "^3.12.0",
+    "next": "14.0.4",
+    "next-mdx-remote": "^4.4.1",
+    "nodemailer": "^6.9.8",
+    "openapi-types": "^12.1.3",
+    "overlayscrollbars": "^2.6.1",
+    "overlayscrollbars-react": "^0.5.4",
+    "passport": "^0.7.0",
+    "passport-google-oauth20": "^2.0.0",
+    "passport-jwt": "^4.0.1",
+    "passport-local": "^1.0.0",
+    "passport-microsoft": "^2.0.0",
+    "patch-package": "^8.0.0",
+    "pg": "^8.11.3",
+    "pg-boss": "^9.0.3",
     "planer": "^1.2.0",
     "pluralize": "^8.0.0",
+    "prettier": "^3.0.3",
+    "prism-react-renderer": "^2.1.0",
+    "qs": "^6.11.2",
     "react": "^18.2.0",
+    "react-data-grid": "7.0.0-beta.13",
+    "react-datepicker": "^6.7.1",
     "react-dom": "^18.2.0",
+    "react-dropzone": "^14.2.3",
+    "react-error-boundary": "^4.0.11",
+    "react-helmet-async": "^1.3.0",
+    "react-hook-form": "^7.45.1",
+    "react-hotkeys-hook": "^4.4.4",
+    "react-icons": "^4.12.0",
+    "react-imask": "^7.6.0",
+    "react-intersection-observer": "^9.15.1",
+    "react-loading-skeleton": "^3.3.1",
+    "react-phone-number-input": "^3.3.4",
     "react-responsive": "^9.0.2",
     "react-router-dom": "^6.4.4",
+    "react-textarea-autosize": "^8.4.1",
     "react-tooltip": "^5.13.1",
     "recoil": "^0.7.7",
+    "rehype-slug": "^6.0.0",
+    "remark-behead": "^3.1.0",
     "remark-gfm": "^3.0.1",
+    "rimraf": "^3.0.2",
     "rxjs": "^7.2.0",
+    "scroll-into-view": "^1.16.2",
     "semver": "^7.5.4",
+    "sharp": "^0.32.1",
     "slash": "^5.1.0",
-    "temporal-polyfill": "^0.3.0",
+    "stripe": "^17.3.1",
     "ts-key-enum": "^2.0.12",
-    "tslib": "^2.8.1",
+    "tslib": "^2.3.0",
+    "tsup": "^8.2.4",
     "type-fest": "4.10.1",
-    "typescript": "5.9.2",
+    "typescript": "5.3.3",
+    "use-context-selector": "^2.0.0",
+    "use-debounce": "^10.0.0",
     "uuid": "^9.0.0",
     "vite-tsconfig-paths": "^4.2.1",
     "xlsx-ugnis": "^0.19.3",
-    "zod": "^4.1.11"
+    "zod": "3.23.8"
   },
   "devDependencies": {
     "@babel/core": "^7.14.5",
     "@babel/preset-react": "^7.14.5",
     "@babel/preset-typescript": "^7.24.6",
-    "@chromatic-com/storybook": "^4.1.3",
+    "@crxjs/vite-plugin": "^1.0.14",
     "@graphql-codegen/cli": "^3.3.1",
     "@graphql-codegen/client-preset": "^4.1.0",
     "@graphql-codegen/typescript": "^3.0.4",
     "@graphql-codegen/typescript-operations": "^3.0.4",
     "@graphql-codegen/typescript-react-apollo": "^3.3.7",
-    "@nx/eslint": "22.3.3",
-    "@nx/eslint-plugin": "22.3.3",
-    "@nx/jest": "22.3.3",
-    "@nx/js": "22.3.3",
-    "@nx/react": "22.3.3",
-    "@nx/storybook": "22.3.3",
-    "@nx/vite": "22.3.3",
-    "@nx/web": "22.3.3",
-    "@sentry/types": "^8",
-    "@storybook-community/storybook-addon-cookie": "^5.0.0",
-    "@storybook/addon-coverage": "^3.0.0",
-    "@storybook/addon-docs": "^10.1.11",
-    "@storybook/addon-links": "^10.1.11",
-    "@storybook/addon-vitest": "^10.1.11",
-    "@storybook/icons": "^2.0.1",
-    "@storybook/react-vite": "^10.1.11",
-    "@storybook/test-runner": "^0.24.2",
+    "@microsoft/microsoft-graph-types": "^2.40.0",
+    "@nestjs/cli": "^9.0.0",
+    "@nestjs/schematics": "^9.0.0",
+    "@nestjs/testing": "^9.0.0",
+    "@next/eslint-plugin-next": "^14.1.4",
+    "@nx/eslint": "18.3.3",
+    "@nx/eslint-plugin": "18.3.3",
+    "@nx/jest": "18.3.3",
+    "@nx/js": "18.3.3",
+    "@nx/react": "18.3.3",
+    "@nx/storybook": "18.3.3",
+    "@nx/vite": "18.3.3",
+    "@nx/web": "18.3.3",
+    "@playwright/test": "^1.46.0",
+    "@sentry/types": "^7.109.0",
+    "@storybook/addon-actions": "^7.6.3",
+    "@storybook/addon-coverage": "^1.0.0",
+    "@storybook/addon-essentials": "^7.6.7",
+    "@storybook/addon-interactions": "^7.6.7",
+    "@storybook/addon-links": "^7.6.7",
+    "@storybook/addon-onboarding": "^1.0.10",
+    "@storybook/blocks": "^7.6.3",
+    "@storybook/core-server": "7.6.3",
+    "@storybook/icons": "^1.2.9",
+    "@storybook/jest": "^0.2.3",
+    "@storybook/react": "^7.6.3",
+    "@storybook/react-vite": "^7.6.3",
+    "@storybook/test": "^7.6.3",
+    "@storybook/test-runner": "^0.16.0",
+    "@storybook/testing-library": "^0.2.2",
     "@stylistic/eslint-plugin": "^1.5.0",
     "@swc-node/register": "1.8.0",
     "@swc/cli": "^0.3.12",
-    "@swc/core": "1.13.3",
+    "@swc/core": "1.7.42",
     "@swc/helpers": "~0.5.2",
-    "@swc/jest": "^0.2.39",
-    "@testing-library/dom": "^10.4.0",
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/react": "^16.3.0",
+    "@testing-library/jest-dom": "^6.1.5",
+    "@testing-library/react": "14.0.0",
     "@types/addressparser": "^1.0.3",
+    "@types/apollo-upload-client": "^17.0.2",
     "@types/bcrypt": "^5.0.0",
+    "@types/better-sqlite3": "^7.6.8",
     "@types/bytes": "^3.1.1",
     "@types/chrome": "^0.0.267",
     "@types/deep-equal": "^1.0.1",
-    "@types/fs-extra": "^11.0.4",
+    "@types/express": "^4.17.13",
+    "@types/file-saver": "^2.0.7",
     "@types/graphql-fields": "^1.3.6",
-    "@types/inquirer": "^9.0.9",
-    "@types/jest": "^30.0.0",
+    "@types/graphql-upload": "^8.0.12",
+    "@types/js-cookie": "^3.0.3",
+    "@types/js-levenshtein": "^1.1.3",
     "@types/lodash.camelcase": "^4.3.7",
     "@types/lodash.compact": "^3.0.9",
+    "@types/lodash.debounce": "^4.0.7",
     "@types/lodash.escaperegexp": "^4.1.9",
     "@types/lodash.groupby": "^4.6.9",
     "@types/lodash.identity": "^3.0.9",
@@ -121,100 +271,101 @@
     "@types/lodash.pickby": "^4.6.9",
     "@types/lodash.snakecase": "^4.1.7",
     "@types/lodash.upperfirst": "^4.3.7",
+    "@types/luxon": "^3.3.0",
     "@types/ms": "^0.7.31",
-    "@types/node": "^24.0.0",
+    "@types/node": "18.19.26",
     "@types/passport-google-oauth20": "^2.0.11",
     "@types/passport-jwt": "^3.0.8",
-    "@types/passport-microsoft": "^2.1.0",
     "@types/pluralize": "^0.0.33",
     "@types/react": "^18.2.39",
     "@types/react-datepicker": "^6.2.0",
     "@types/react-dom": "^18.2.15",
+    "@types/scroll-into-view": "^1.16.0",
     "@types/supertest": "^2.0.11",
     "@types/uuid": "^9.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.39.0",
-    "@typescript-eslint/parser": "^8.39.0",
-    "@typescript-eslint/utils": "^8.39.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260116.1",
-    "@vitejs/plugin-react-swc": "3.11.0",
-    "@vitest/browser-playwright": "^4.0.17",
-    "@vitest/coverage-istanbul": "^4.0.17",
-    "@vitest/coverage-v8": "^4.0.17",
+    "@typescript-eslint/eslint-plugin": "6.21.0",
+    "@typescript-eslint/experimental-utils": "^5.62.0",
+    "@typescript-eslint/parser": "6.21.0",
+    "@typescript-eslint/utils": "6.21.0",
+    "@vitejs/plugin-react-swc": "^3.5.0",
+    "@vitest/ui": "1.4.0",
     "@yarnpkg/types": "^4.0.0",
     "chromatic": "^6.18.0",
     "concurrently": "^8.2.2",
-    "danger": "^13.0.4",
-    "dotenv-cli": "^7.4.4",
-    "esbuild": "^0.25.10",
-    "eslint": "^9.32.0",
+    "cross-var": "^1.1.0",
+    "danger": "^11.3.0",
+    "dotenv-cli": "^7.2.1",
+    "drizzle-kit": "^0.20.14",
+    "esbuild": "^0.23.0",
+    "eslint": "^8.53.0",
+    "eslint-config-next": "14.0.4",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-import": "2.29.1",
+    "eslint-plugin-jsx-a11y": "^6.8.0",
     "eslint-plugin-lingui": "^0.9.0",
-    "eslint-plugin-mdx": "^3.6.2",
     "eslint-plugin-prefer-arrow": "^1.2.3",
     "eslint-plugin-prettier": "^5.1.2",
     "eslint-plugin-project-structure": "^3.9.1",
-    "eslint-plugin-react": "^7.37.2",
-    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react": "^7.33.2",
+    "eslint-plugin-react-hooks": "^4.6.0",
     "eslint-plugin-react-refresh": "^0.4.4",
     "eslint-plugin-simple-import-sort": "^10.0.0",
-    "eslint-plugin-storybook": "^10.1.11",
-    "eslint-plugin-unicorn": "^56.0.1",
+    "eslint-plugin-storybook": "^0.6.15",
+    "eslint-plugin-unicorn": "^51.0.1",
     "eslint-plugin-unused-imports": "^3.0.0",
     "http-server": "^14.1.1",
     "jest": "29.7.0",
-    "jest-environment-jsdom": "30.0.0-beta.3",
+    "jest-environment-jsdom": "29.7.0",
     "jest-environment-node": "^29.4.1",
     "jest-fetch-mock": "^3.0.3",
     "jsdom": "~22.1.0",
-    "msw": "^2.12.7",
-    "msw-storybook-addon": "^2.0.6",
-    "nx": "22.3.3",
+    "msw": "^2.0.11",
+    "msw-storybook-addon": "2.0.0--canary.122.b3ed3b1.0",
+    "nx": "18.3.3",
+    "playwright": "^1.46.0",
     "prettier": "^3.1.1",
     "raw-loader": "^4.0.2",
     "rimraf": "^5.0.5",
     "source-map-support": "^0.5.20",
-    "storybook": "^10.1.11",
-    "storybook-addon-mock-date": "2.0.0",
-    "storybook-addon-pseudo-states": "^10.1.11",
+    "storybook": "^7.6.3",
+    "storybook-addon-cookie": "^3.2.0",
+    "storybook-addon-pseudo-states": "^2.1.2",
+    "storybook-dark-mode": "^3.0.3",
     "supertest": "^6.1.3",
     "ts-jest": "^29.1.1",
     "ts-loader": "^9.2.3",
     "ts-node": "10.9.1",
     "tsconfig-paths": "^4.2.0",
     "tsx": "^4.17.0",
-    "vite": "^7.0.0",
-    "vitest": "^4.0.17"
+    "vite": "^5.4.0",
+    "vite-plugin-checker": "^0.6.2",
+    "vite-plugin-dts": "3.8.1",
+    "vite-plugin-svgr": "^4.2.0",
+    "vitest": "1.4.0"
   },
   "engines": {
-    "node": "^24.5.0",
+    "node": "^18.17.1",
     "npm": "please-use-yarn",
     "yarn": ">=4.0.2"
   },
   "license": "AGPL-3.0",
   "name": "twenty",
-  "packageManager": "yarn@4.9.2",
+  "packageManager": "yarn@4.4.0",
   "resolutions": {
-    "graphql": "16.8.1",
+    "graphql": "16.8.0",
     "type-fest": "4.10.1",
-    "typescript": "5.9.2",
-    "graphql-redis-subscriptions/ioredis": "^5.6.0",
-    "prosemirror-view": "1.40.0",
-    "prosemirror-transform": "1.10.4",
-    "@lingui/core": "5.1.2",
-    "@types/qs": "6.9.16"
+    "typescript": "5.3.3",
+    "prosemirror-model": "1.23.0",
+    "yjs": "13.6.18"
   },
   "version": "0.2.1",
   "nx": {},
   "scripts": {
-    "docs:generate": "tsx packages/twenty-docs/scripts/generate-docs-json.ts",
-    "docs:generate-navigation-template": "tsx packages/twenty-docs/scripts/generate-navigation-template.ts",
-    "docs:generate-paths": "tsx packages/twenty-docs/scripts/generate-documentation-paths.ts",
     "start": "npx concurrently --kill-others 'npx nx run-many -t start -p twenty-server twenty-front' 'npx wait-on tcp:3000 && npx nx run twenty-server:worker'"
   },
   "workspaces": {
     "packages": [
+      "packages/twenty-chrome-extension",
       "packages/twenty-front",
       "packages/twenty-server",
       "packages/twenty-emails",
@@ -222,19 +373,9 @@
       "packages/twenty-utils",
       "packages/twenty-zapier",
       "packages/twenty-website",
-      "packages/twenty-docs",
       "packages/twenty-e2e-testing",
       "packages/twenty-shared",
-      "packages/twenty-sdk",
-      "packages/twenty-apps",
-      "packages/twenty-cli",
-      "packages/create-twenty-app",
-      "packages/twenty-eslint-rules"
+      "tools/eslint-rules"
     ]
-  },
-  "prettier": {
-    "singleQuote": true,
-    "trailingComma": "all",
-    "endOfLine": "lf"
   }
 }

packages/create-twenty-app/README.md

@@ -1,109 +0,0 @@
-<div align="center">
-  <a href="https://twenty.com">
-    <picture>
-      <img alt="Twenty logo" src="https://raw.githubusercontent.com/twentyhq/twenty/2f25922f4cd5bd61e1427c57c4f8ea224e1d552c/packages/twenty-website/public/images/core/logo.svg" height="128">
-    </picture>
-  </a>
-  <h1>Create Twenty App</h1>
-
-<a href="https://www.npmjs.com/package/create-twenty-app"><img alt="NPM version" src="https://img.shields.io/npm/v/create-twenty-app.svg?style=for-the-badge&labelColor=000000"></a>
-<a href="https://github.com/twentyhq/twenty/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/npm/l/next.svg?style=for-the-badge&labelColor=000000"></a>
-<a href="https://discord.gg/cx5n4Jzs57"><img alt="Join the community on Discord" src="https://img.shields.io/badge/Join%20the%20community-blueviolet.svg?style=for-the-badge&logo=Twenty&labelColor=000000&logoWidth=20"></a>
-
-</div>
-
-Create Twenty App is the official scaffolding CLI for building apps on top of [Twenty CRM](https://twenty.com). It sets up a ready‑to‑run project that works seamlessly with the [twenty-sdk](https://www.npmjs.com/package/twenty-sdk).
-
-- Zero‑config project bootstrap
-- Preconfigured scripts for auth, dev mode (watch & sync), generate, uninstall, and function management
-- Strong TypeScript support and typed client generation
-
-## Documentation
-See Twenty application documentation https://docs.twenty.com/developers/extend/capabilities/apps
-
-## Prerequisites
-- Node.js 24+ (recommended) and Yarn 4
-- A Twenty workspace and an API key (create one at https://app.twenty.com/settings/api-webhooks)
-
-## Quick start
-
-```bash
-npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# If you don't use yarn@4
-corepack enable
-yarn install
-
-# Get help
-yarn run help
-
-# Authenticate using your API key (you'll be prompted)
-yarn auth:login
-
-# Add a new entity to your application (guided)
-yarn entity:add
-
-# Generate a typed Twenty client and workspace entity types
-yarn app:generate
-
-# Start dev mode: watches, builds, and syncs local changes to your workspace
-yarn app:dev
-
-# Watch your application's function logs
-yarn function:logs
-
-# Execute a function with a JSON payload
-yarn function:execute -n my-function -p '{"key": "value"}'
-
-# Uninstall the application from the current workspace
-yarn app:uninstall
-```
-
-## What gets scaffolded
-- A minimal app structure ready for Twenty with example files:
-  - `application-config.ts` - Application metadata configuration
-  - `roles/default-role.ts` - Default role for logic functions
-  - `logic-functions/hello-world.ts` - Example logic function with HTTP trigger
-  - `front-components/hello-world.tsx` - Example front component
-- TypeScript configuration
-- Prewired scripts that wrap the `twenty` CLI from twenty-sdk
-
-## Next steps
-- Use `yarn auth:login` to authenticate with your Twenty workspace.
-- Explore the generated project and add your first entity with `yarn entity:add` (logic functions, front components, objects, roles).
-- Use `yarn app:dev` while you iterate — it watches, builds, and syncs changes to your workspace in real time.
-- Keep your types up‑to‑date using `yarn app:generate`.
-
-
-## Publish your application
-Applications are currently stored in `twenty/packages/twenty-apps`.
-
-You can share your application with all Twenty users:
-
-```bash
-# pull the Twenty project
-git clone https://github.com/twentyhq/twenty.git
-cd twenty
-
-# create a new branch
-git checkout -b feature/my-awesome-app
-```
-
-- Copy your app folder into `twenty/packages/twenty-apps`.
-- Commit your changes and open a pull request on https://github.com/twentyhq/twenty
-
-```bash
-git commit -m "Add new application"
-git push
-```
-
-Our team reviews contributions for quality, security, and reusability before merging.
-
-## Troubleshooting
-- Auth prompts not appearing: run `yarn auth:login` again and verify the API key permissions.
-- Types not generated: ensure `yarn app:generate` runs without errors, then re‑start `yarn app:dev`.
-
-## Contributing
-- See our [GitHub](https://github.com/twentyhq/twenty)
-- Join our [Discord](https://discord.gg/cx5n4Jzs57)

packages/create-twenty-app/eslint.config.mjs

@@ -1,20 +0,0 @@
-import baseConfig from '../../eslint.config.mjs';
-
-export default [
-  ...baseConfig,
-  {
-    ignores: ['**/dist/**'],
-  },
-  {
-    files: ['**/*.{js,jsx,ts,tsx}'],
-    rules: {
-      'prettier/prettier': 'error',
-    },
-  },
-  {
-    rules: {
-      'no-console': 'off',
-    },
-    ignores: ['src/**/*.ts', '!src/cli/**/*.ts'],
-  },
-];

packages/create-twenty-app/jest.config.mjs

@@ -1,40 +0,0 @@
-const jestConfig = {
-  displayName: 'twenty-cli',
-  preset: '../../jest.preset.js',
-  testEnvironment: 'node',
-  transformIgnorePatterns: ['../../node_modules/'],
-  transform: {
-    '^.+\\.[tj]sx?$': [
-      '@swc/jest',
-      {
-        jsc: {
-          parser: { syntax: 'typescript', tsx: false },
-        },
-      },
-    ],
-  },
-  moduleNameMapper: {
-    '^@/(.*)$': '<rootDir>/src/$1',
-  },
-  moduleFileExtensions: ['ts', 'js'],
-  extensionsToTreatAsEsm: ['.ts'],
-  coverageDirectory: './coverage',
-  testMatch: [
-    '<rootDir>/src/**/__tests__/**/*.(test|spec).{js,ts}',
-    '<rootDir>/src/**/?(*.)(test|spec).{js,ts}',
-  ],
-  collectCoverageFrom: [
-    'src/**/*.{ts,js}',
-    '!src/**/*.d.ts',
-    '!src/cli.ts', // Exclude CLI entry point from coverage
-  ],
-  coverageThreshold: {
-    global: {
-      statements: 1,
-      lines: 1,
-      functions: 1,
-    },
-  },
-};
-
-export default jestConfig;

packages/create-twenty-app/package.json

@@ -1,60 +0,0 @@
-{
-  "name": "create-twenty-app",
-  "version": "0.5.0",
-  "description": "Command-line interface to create Twenty application",
-  "main": "dist/cli.cjs",
-  "bin": "dist/cli.cjs",
-  "files": [
-    "dist",
-    "README.md",
-    "package.json"
-  ],
-  "scripts": {
-    "build": "npx rimraf dist && npx vite build",
-    "prepublishOnly": "tsx ../twenty-utils/pack-scripts/pre-publish-only.ts",
-    "postpublish": "tsx ../twenty-utils/pack-scripts/post-publish.ts"
-  },
-  "keywords": [
-    "twenty",
-    "cli",
-    "crm",
-    "application",
-    "development"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/cli.d.ts",
-      "import": "./dist/cli.mjs",
-      "require": "./dist/cli.cjs"
-    }
-  },
-  "license": "AGPL-3.0",
-  "dependencies": {
-    "@genql/cli": "^3.0.3",
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "fs-extra": "^11.2.0",
-    "inquirer": "^10.0.0",
-    "lodash.camelcase": "^4.3.0",
-    "lodash.kebabcase": "^4.1.1",
-    "lodash.startcase": "^4.4.0",
-    "twenty-shared": "workspace:*",
-    "uuid": "^13.0.0"
-  },
-  "devDependencies": {
-    "@types/fs-extra": "^11.0.0",
-    "@types/inquirer": "^9.0.0",
-    "@types/lodash.camelcase": "^4.3.7",
-    "@types/lodash.kebabcase": "^4.1.7",
-    "@types/lodash.startcase": "^4",
-    "@types/node": "^20.0.0",
-    "typescript": "^5.9.2",
-    "vite": "^7.0.0",
-    "vite-plugin-dts": "^4.5.4",
-    "vite-tsconfig-paths": "^4.2.1"
-  },
-  "engines": {
-    "node": "^24.5.0",
-    "yarn": "^4.0.2"
-  }
-}

packages/create-twenty-app/project.json

@@ -1,56 +0,0 @@
-{
-  "name": "create-twenty-app",
-  "$schema": "../../node_modules/nx/schemas/project-schema.json",
-  "projectType": "library",
-  "tags": ["scope:create-app"],
-  "targets": {
-    "build": {
-      "dependsOn": ["^build"],
-      "outputs": ["{projectRoot}/dist"]
-    },
-    "dev": {
-      "executor": "nx:run-commands",
-      "dependsOn": ["build"],
-      "options": {
-        "cwd": "packages/create-twenty-app",
-        "command": "tsx src/cli.ts"
-      }
-    },
-    "start": {
-      "executor": "nx:run-commands",
-      "dependsOn": ["build"],
-      "options": {
-        "cwd": "packages/create-twenty-app",
-        "command": "node dist/cli.cjs"
-      }
-    },
-    "typecheck": {},
-    "lint": {
-      "options": {
-        "lintFilePatterns": ["{projectRoot}/src/**/*.{ts,json}"],
-        "maxWarnings": 0
-      },
-      "configurations": {
-        "ci": {
-          "lintFilePatterns": ["{projectRoot}/src/**/*.{ts,json}"],
-          "maxWarnings": 0
-        },
-        "fix": {}
-      }
-    },
-    "test": {
-      "executor": "@nx/jest:jest",
-      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
-      "options": {
-        "jestConfig": "{projectRoot}/jest.config.mjs"
-      },
-      "configurations": {
-        "ci": {
-          "ci": true,
-          "coverage": true,
-          "watchAll": false
-        }
-      }
-    }
-  }
-}