Fix 1-15 upgrade commands bundle (#16957)

Fixes https://github.com/twentyhq/twenty/issues/16837

Current flow:
- create workflow run optimistically 
- open side panel => triggers query + event stream
- mutation that actually creates the run using the optimistic id

New flow
- create workflow run optimistically 
- mutation that actually creates the run using the optimistic id
- open side panel => triggers query + event stream

.cursor/rules/README.mdc

@@ -56,7 +56,9 @@ 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 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
 ```
@@ -70,7 +72,9 @@ 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 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

.cursor/rules/nx-rules.mdc

@@ -12,7 +12,12 @@ alwaysApply: true
 npx nx run twenty-front:build
 npx nx run twenty-server:test
 
-# Run target for all projects
+# 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
 
@@ -43,12 +48,18 @@ npx nx g @nx/react:component my-component
 }
 ```
 
+## 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
+# Check what's affected by changes (runs target on affected projects)
 npx nx affected --target=test
 npx nx affected --target=build --base=main
 ```

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

@@ -20,7 +20,7 @@ runs:
       id: cache-primary-key-builder
       shell: bash
       run: |
-        echo "CACHE_PRIMARY_KEY_PREFIX=v3-${{ inputs.key }}-${{ github.ref_name }}" >> "${GITHUB_OUTPUT}"
+        echo "CACHE_PRIMARY_KEY_PREFIX=v4-${{ inputs.key }}-${{ github.ref_name }}" >> "${GITHUB_OUTPUT}"
     - name: Restore cache
       uses: actions/cache/restore@v4
       id: restore-cache
@@ -32,4 +32,4 @@ runs:
           .nx
           node_modules/.cache
           packages/*/node_modules/.cache
-          ${{ inputs.additional-paths }}
+          ${{ inputs.additional-paths }}

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

@@ -63,9 +63,9 @@ jobs:
           - 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-cmd "clickhouse-client --host=localhost --port=9000 --user=default --password=clickhousePassword --query='SELECT 1'"
+          --health-interval 10s
+          --health-timeout 5s
           --health-retries 5
 
     steps:
@@ -78,12 +78,12 @@ jobs:
         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
@@ -91,16 +91,16 @@ jobs:
           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/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
 
       - name: Build shared dependencies
         run: |
@@ -128,22 +128,22 @@ jobs:
             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
 
@@ -166,19 +166,19 @@ jobs:
           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:"
@@ -188,15 +188,15 @@ jobs:
 
       - name: Download GraphQL and REST responses from current branch
         run: |
-          # Admin token from jest-integration.config.ts
-          ADMIN_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC05ZTNiLTQ2ZDQtYTU1Ni04OGI5ZGRjMmIwMzQiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtMDY4Ny00YzQxLWI3MDctZWQxYmZjYTk3MmE3IiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtOWUzYi00NmQ0LWE1NTYtODhiOWRkYzJiMDM1IiwiaWF0IjoxNzM5NTQ3NjYxLCJleHAiOjMzMjk3MTQ3NjYxfQ.fbOM9yhr3jWDicPZ1n771usUURiPGmNdeFApsgrbxOw"
-          
+          # 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" \
@@ -205,7 +205,7 @@ jobs:
             -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" \
@@ -214,32 +214,32 @@ jobs:
             -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
@@ -263,7 +263,7 @@ jobs:
           rm -rf node_modules packages/*/node_modules packages/*/dist dist .nx/cache
 
       - name: Install dependencies for main branch
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
 
       - name: Build main branch dependencies
         run: |
@@ -281,22 +281,22 @@ jobs:
             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
 
@@ -319,19 +319,19 @@ jobs:
           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:"
@@ -341,15 +341,15 @@ jobs:
 
       - name: Download GraphQL and REST responses from main branch
         run: |
-          # Admin token from jest-integration.config.ts
-          ADMIN_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC05ZTNiLTQ2ZDQtYTU1Ni04OGI5ZGRjMmIwMzQiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtMDY4Ny00YzQxLWI3MDctZWQxYmZjYTk3MmE3IiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtOWUzYi00NmQ0LWE1NTYtODhiOWRkYzJiMDM1IiwiaWF0IjoxNzM5NTQ3NjYxLCJleHAiOjMzMjk3MTQ3NjYxfQ.fbOM9yhr3jWDicPZ1n771usUURiPGmNdeFApsgrbxOw"
-          
+          # 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" \
@@ -358,7 +358,7 @@ jobs:
             -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" \
@@ -367,33 +367,33 @@ jobs:
             -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
 
@@ -406,9 +406,9 @@ jobs:
         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
@@ -426,7 +426,7 @@ jobs:
               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
@@ -444,7 +444,7 @@ jobs:
               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)"
@@ -452,32 +452,32 @@ jobs:
       - 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
@@ -493,7 +493,7 @@ jobs:
                   (.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
@@ -503,7 +503,7 @@ jobs:
             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
@@ -512,7 +512,7 @@ jobs:
             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
@@ -520,33 +520,33 @@ jobs:
       - 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 
+
+              # Parse and format the changes from Java openapi-diff
               jq -r '
                 if (.missingEndpoints | length) > 0 then
                   "## 🚨 Removed Endpoints (" + (.missingEndpoints | length | tostring) + ")\n" +
@@ -570,7 +570,7 @@ jobs:
             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
@@ -579,7 +579,7 @@ jobs:
             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
@@ -592,7 +592,7 @@ jobs:
             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');
@@ -604,7 +604,7 @@ jobs:
                   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()) {
@@ -615,7 +615,7 @@ jobs:
                   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()) {
@@ -626,7 +626,7 @@ jobs:
                   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()) {
@@ -637,37 +637,37 @@ jobs:
                   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('🚨') || 
+                  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('🚨') || 
+                  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');
@@ -675,18 +675,18 @@ jobs:
                     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' +
@@ -702,20 +702,20 @@ jobs:
                       '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({
@@ -737,17 +737,17 @@ jobs:
                 }
               } 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,
@@ -780,7 +780,7 @@ jobs:
             /tmp/main-server.log
             /tmp/current-server.log
             *-api.json
-            *-schema-introspection.json  
+            *-schema-introspection.json
             *-diff.md
             *-diff.json
 

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

@@ -27,7 +27,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        task: [lint, typecheck, test, build]
+        task: [lint, typecheck, test]
     steps:
       - name: Cancel Previous Runs
         uses: styfle/cancel-workflow-action@0.11.0
@@ -38,9 +38,11 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
+      - name: Build
+        run: npx nx build create-twenty-app
       - name: Run ${{ matrix.task }} task
-        uses: ./.github/workflows/actions/nx-affected
+        uses: ./.github/actions/nx-affected
         with:
           tag: scope:create-app
           tasks: ${{ matrix.task }}

.github/workflows/ci-docs.yaml

@@ -40,7 +40,7 @@ jobs:
           fetch-depth: 0
 
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        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

@@ -1,136 +0,0 @@
-name: CI E2E Playwright Tests
-
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-    types: [opened, synchronize, reopened, labeled]
-
-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/**
-          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:
-      # 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: 5
-      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

@@ -32,7 +32,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Build twenty-emails
         run: npx nx build twenty-emails
       - name: Run email tests
@@ -40,17 +40,17 @@ jobs:
           # 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:
@@ -61,4 +61,4 @@ jobs:
     steps:
       - name: Fail job if any needs failed
         if: contains(needs.*.result, 'failure')
-        run: exit 1 
+        run: exit 1

.github/workflows/ci-front.yaml

@@ -1,4 +1,4 @@
-name: CI Front
+name: CI Front and E2E
 
 on:
   push:
@@ -7,6 +7,8 @@ on:
 
   pull_request:
 
+  merge_group:
+
 permissions:
   contents: read
 
@@ -15,8 +17,9 @@ concurrency:
   cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
 
 env:
+  # restore-cache action adds 'v4-' prefix and '-<branch>-<sha>' suffix to the key
   STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION: storybook-build-depot-ubuntu-24.04-8-runner
-  STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION: v3-storybook-build-depot-ubuntu-24.04-8-runner-${{ github.ref_name }}-${{ github.sha }}
+  STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION: v4-storybook-build-depot-ubuntu-24.04-8-runner-${{ github.ref_name }}-${{ github.sha }}
 
 jobs:
   changed-files-check:
@@ -28,6 +31,13 @@ jobs:
         packages/twenty-front/**
         packages/twenty-ui/**
         packages/twenty-shared/**
+  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
     if: needs.changed-files-check.outputs.any_changed == 'true'
@@ -45,15 +55,17 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Diagnostic disk space issue
         run: df -h
       - name: Front / Write .env
         run: npx nx reset:env twenty-front
+      - name: Front / Clean storybook-static
+        run: rm -rf packages/twenty-front/storybook-static
       - name: Front / Build storybook
         run: npx nx storybook:build twenty-front
       - name: Save storybook build cache
-        uses: ./.github/workflows/actions/save-cache
+        uses: ./.github/actions/save-cache
         with:
           key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION }}
   front-sb-test:
@@ -74,11 +86,11 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Install Playwright
         run: cd packages/twenty-front && npx playwright install
       - name: Restore storybook build cache
-        uses: ./.github/workflows/actions/restore-cache
+        uses: ./.github/actions/restore-cache
         with:
           key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION }}
       - name: Front / Write .env
@@ -107,7 +119,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - uses: actions/download-artifact@v4
         with:
           pattern: coverage-artifacts-${{ matrix.storybook_scope }}-${{ github.run_id }}-*
@@ -121,7 +133,7 @@ jobs:
         run: npx nx storybook:coverage twenty-front --checkCoverage=true --configuration=${{ matrix.storybook_scope }}
   front-chromatic-deployment:
     timeout-minutes: 30
-    if: contains(github.event.pull_request.labels.*.name, 'run-chromatic') || github.event_name == 'push'
+    if: false
     needs: front-sb-build
     runs-on: depot-ubuntu-24.04-8
     env:
@@ -132,11 +144,11 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Restore storybook build cache
-        uses: ./.github/workflows/actions/restore-cache
+        uses: ./.github/actions/restore-cache
         with:
-          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY }}
+          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION }}
       - name: Front / Write .env
         run: |
           cd packages/twenty-front
@@ -165,26 +177,162 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Restore ${{ matrix.task }} cache
         id: restore-task-cache
-        uses: ./.github/workflows/actions/restore-cache
+        uses: ./.github/actions/restore-cache
         with:
           key: ${{ env.TASK_CACHE_KEY }}
       - name: Reset .env
-        uses: ./.github/workflows/actions/nx-affected
+        uses: ./.github/actions/nx-affected
         with:
           tag: scope:frontend
           tasks: reset:env
       - name: Run ${{ matrix.task }} task
-        uses: ./.github/workflows/actions/nx-affected
+        uses: ./.github/actions/nx-affected
         with:
           tag: scope:frontend
           tasks: ${{ matrix.task }}
       - name: Save ${{ matrix.task }} cache
-        uses: ./.github/workflows/actions/save-cache
+        uses: ./.github/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: depot-ubuntu-24.04-8
+    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
@@ -193,7 +341,7 @@ jobs:
       [
         changed-files-check,
         front-task,
-        front-chromatic-deployment,
+        front-build,
         merge-reports-and-check-coverage,
         front-sb-test,
         front-sb-build,
@@ -202,3 +350,23 @@ jobs:
       - name: Fail job if any needs failed
         if: contains(needs.*.result, 'failure')
         run: exit 1
+  ci-e2e-status-check:
+    if: always() && !cancelled() && github.event_name != 'merge_group'
+    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
+  ci-e2e-merge-queue-check:
+    if: |
+      always() && !cancelled() && github.event_name == 'merge_group'
+    timeout-minutes: 5
+    runs-on: ubuntu-latest
+    name: ${{ github.event_name == 'merge_group' && 'ci-e2e-merge-queue-check' || 'ci-e2e-status-check' }}
+    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

@@ -56,4 +56,4 @@ jobs:
           title: Release v${{ steps.sanitize.outputs.version }}
           labels: |
             release
-            ${{ github.event.inputs.create_release == true && 'create_release' || '' }}
+            ${{ github.event.inputs.create_release == true && 'create_release' || '' }}

.github/workflows/ci-sdk.yaml

@@ -27,7 +27,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        task: [lint, typecheck, test, build]
+        task: [lint, typecheck, test]
     steps:
       - name: Cancel Previous Runs
         uses: styfle/cancel-workflow-action@0.11.0
@@ -38,9 +38,11 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
+      - name: Build
+        run: npx nx build twenty-sdk
       - name: Run ${{ matrix.task }} task
-        uses: ./.github/workflows/actions/nx-affected
+        uses: ./.github/actions/nx-affected
         with:
           tag: scope:sdk
           tasks: ${{ matrix.task }}
@@ -76,7 +78,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Server / Append billing config to .env.test
         working-directory: packages/twenty-server
         run: |

.github/workflows/ci-server.yaml

@@ -59,16 +59,16 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Restore server setup
         id: restore-server-setup-cache
-        uses: ./.github/workflows/actions/restore-cache
+        uses: ./.github/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/workflows/actions/nx-affected
+        uses: ./.github/actions/nx-affected
         with:
           tag: scope:backend
           tasks: lint,typecheck
@@ -140,7 +140,7 @@ jobs:
             exit 1
           fi
       - name: Save server setup
-        uses: ./.github/workflows/actions/save-cache
+        uses: ./.github/actions/save-cache
         with:
           key: ${{ steps.restore-server-setup-cache.outputs.cache-primary-key }}
   server-test:
@@ -153,13 +153,13 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Restore server setup
-        uses: ./.github/workflows/actions/restore-cache
+        uses: ./.github/actions/restore-cache
         with:
           key: ${{ env.SERVER_SETUP_CACHE_KEY }}
       - name: Server / Run Tests
-        uses: ./.github/workflows/actions/nx-affected
+        uses: ./.github/actions/nx-affected
         with:
           tag: scope:backend
           tasks: test
@@ -171,7 +171,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        shard: [1, 2, 3, 4, 5]
+        shard: [1, 2, 3, 4, 5, 6, 7, 8]
     services:
       postgres:
         image: twentycrm/twenty-postgres-spilo
@@ -209,14 +209,14 @@ jobs:
       ANALYTICS_ENABLED: true
       CLICKHOUSE_URL: "http://default:clickhousePassword@localhost:8123/twenty"
       CLICKHOUSE_PASSWORD: clickhousePassword
-      SHARD_COUNTER: 5
+      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/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Update .env.test for integrations tests
         run: |
           echo "" >> .env.test
@@ -226,7 +226,7 @@ jobs:
           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/workflows/actions/restore-cache
+        uses: ./.github/actions/restore-cache
         with:
           key: ${{ env.SERVER_SETUP_CACHE_KEY }}
       - name: Server / Build
@@ -243,7 +243,7 @@ jobs:
       - name: Run ClickHouse seeds
         run: npx nx clickhouse:seed twenty-server
       - name: Server / Run Integration Tests
-        uses: ./.github/workflows/actions/nx-affected
+        uses: ./.github/actions/nx-affected
         with:
           tag: scope:backend
           tasks: 'test:integration'

.github/workflows/ci-shared.yaml

@@ -38,9 +38,9 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Run ${{ matrix.task }} task
-        uses: ./.github/workflows/actions/nx-affected
+        uses: ./.github/actions/nx-affected
         with:
           tag: scope:frontend
           tasks: ${{ matrix.task }}

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

@@ -1,4 +1,4 @@
-name: 'Test Docker Compose'
+name: CI Docker Compose
 
 permissions:
   contents: read

.github/workflows/ci-utils.yaml

@@ -30,12 +30,12 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/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 +43,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
       - name: Run congratulate-dangerfile.js
         run: cd packages/twenty-utils && npx nx danger:congratulate
         env:

.github/workflows/ci-website.yaml

@@ -47,7 +47,7 @@ jobs:
           fetch-depth: 0
 
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
 
       - name: Server / Create DB
         run: PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'

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

@@ -24,7 +24,7 @@ on:
   pull_request:
     paths:
       - 'packages/twenty-docs/**'
-      - 'crowdin.yml'
+      - 'crowdin-docs.yml'
       - '.github/workflows/docs-i18n-pull.yaml'
 
 concurrency:
@@ -42,31 +42,14 @@ jobs:
           token: ${{ github.token }}
           ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'yarn'
-          cache-dependency-path: 'yarn.lock'
-
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        uses: ./.github/actions/yarn-install
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'yarn'
-          cache-dependency-path: 'yarn.lock'
-
-      - name: Install dependencies
-        run: yarn install --frozen-lockfile
-
-      - name: Setup i18n branch
+      - name: Setup i18n-docs branch
         if: github.event_name != 'pull_request'
         run: |
-          git fetch origin i18n || true
-          git checkout -B i18n origin/i18n || git checkout -b i18n
+          git fetch origin i18n-docs || true
+          git checkout -B i18n-docs origin/i18n-docs || git checkout -b i18n-docs
 
       - name: Configure git
         run: |
@@ -79,26 +62,35 @@ jobs:
           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')
-        uses: crowdin/github-action@v2
-        with:
-          upload_sources: false
-          upload_translations: false
-          download_translations: true
-          source: 'packages/twenty-docs/**/*.mdx'
-          translation: 'packages/twenty-docs/l/%two_letters_code%/**/%original_file_name%'
-          export_only_approved: false
-          localization_branch_name: i18n
-          base_url: 'https://twenty.api.crowdin.com'
-          skip_untranslated_files: true
-          push_translations: false
-          create_pull_request: false
-          skip_ref_checkout: true
-          dryrun_action: false
+        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 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:
-          GITHUB_TOKEN: ${{ github.token }}
-          CROWDIN_PROJECT_ID: '1'
           CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
 
       - name: Fix file permissions
@@ -142,13 +134,13 @@ jobs:
 
       - name: Push changes
         if: github.event_name != 'pull_request' && steps.check_changes.outputs.changes_detected == 'true'
-        run: git push origin HEAD:i18n
+        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 --title 'i18n - docs translations' --body 'Created by Github action' || true
+            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

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

@@ -7,11 +7,12 @@ on:
   workflow_dispatch:
   workflow_call:
   push:
-    branches: ['main', 'docs-localized-navigation']
+    branches: ['main']
     paths:
       - 'packages/twenty-docs/**/*.mdx'
-      - '!packages/twenty-docs/fr/**'
-      - 'crowdin.yml'
+      - '!packages/twenty-docs/l/**'
+      - 'packages/twenty-docs/navigation/navigation.template.json'
+      - 'crowdin-docs.yml'
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
@@ -28,28 +29,8 @@ jobs:
           token: ${{ github.token }}
           ref: ${{ github.ref }}
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'yarn'
-          cache-dependency-path: 'yarn.lock'
-
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
-
-      - name: Generate navigation template for Crowdin
-        run: yarn docs:generate-navigation-template
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'yarn'
-          cache-dependency-path: 'yarn.lock'
-
-      - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        uses: ./.github/actions/yarn-install
 
       - name: Generate navigation template for Crowdin
         run: yarn docs:generate-navigation-template
@@ -60,9 +41,11 @@ jobs:
           upload_sources: true
           upload_translations: false
           download_translations: false
-          localization_branch_name: i18n
+          localization_branch_name: i18n-docs
           base_url: 'https://twenty.api.crowdin.com'
+          config: 'crowdin-docs.yml'
         env:
-          CROWDIN_PROJECT_ID: 1
+          # Docs translations project
+          CROWDIN_PROJECT_ID: '2'
           CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
 

.github/workflows/i18n-pull.yaml

@@ -46,7 +46,7 @@ jobs:
           git checkout -B i18n origin/i18n || git checkout -b i18n
 
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
 
       - name: Build twenty-shared
         run: npx nx build twenty-shared
@@ -85,12 +85,14 @@ jobs:
           push_sources: false
           skip_untranslated_strings: false
           skip_untranslated_files: false
-          push_translations: true
+          push_translations: false
           create_pull_request: false
           skip_ref_checkout: true
           dryrun_action: false
+          config: 'crowdin-app.yml'
         env:
           GITHUB_TOKEN: ${{ github.token }}
+          # App translations project
           CROWDIN_PROJECT_ID: '1'
           CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
 
@@ -99,6 +101,12 @@ jobs:
       - 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
@@ -108,8 +116,6 @@ jobs:
           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

@@ -31,7 +31,7 @@ jobs:
           git checkout -B i18n origin/i18n || git checkout -b i18n
 
       - name: Install dependencies
-        uses: ./.github/workflows/actions/yarn-install
+        uses: ./.github/actions/yarn-install
 
       - name: Build dependencies
         run: npx nx build twenty-shared
@@ -87,11 +87,10 @@ jobs:
           download_translations: false
           localization_branch_name: i18n
           base_url: 'https://twenty.api.crowdin.com'
+          config: 'crowdin-app.yml'
         env:
-          # 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
+          # App translations project
+          CROWDIN_PROJECT_ID: '1'
           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

@@ -0,0 +1,118 @@
+# 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 }}

.gitignore

@@ -48,3 +48,4 @@ dump.rdb
 
 mcp.json
 /.junie/
+TRANSLATION_QA_REPORT.md

.vscode/settings.json

@@ -31,6 +31,7 @@
     "editor.formatOnSave": true
   },
   "javascript.format.enable": false,
+  "javascript.preferences.importModuleSpecifier": "non-relative",
   "typescript.format.enable": false,
   "cSpell.enableFiletypes": [
     "!javascript",

CLAUDE.md

@@ -36,10 +36,15 @@ When testing the UI end to end, click on "Continue with Email" and use the prefi
 
 ### Code Quality
 ```bash
-# Linting
-npx nx lint twenty-front      # Frontend linting
-npx nx lint twenty-server     # Backend linting
-npx nx lint twenty-front --fix  # Auto-fix linting issues
+# Linting (diff with main - fastest)
+npx nx lint:diff-with-main twenty-front           # Lint only files changed vs main
+npx nx lint:diff-with-main twenty-server          # Lint only files changed vs main
+npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix files changed vs main
+
+# Linting (full project)
+npx nx lint twenty-front      # Lint all files in frontend
+npx nx lint twenty-server     # Lint all files in backend
+npx nx lint twenty-front --fix  # Auto-fix all linting issues
 
 # Type checking
 npx nx typecheck twenty-front

crowdin-app.yml

@@ -0,0 +1,22 @@
+#
+# 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
+
+files: [
+  {
+    #
+    # Source files filter - PO files for Lingui
+    #
+    "source": "**/en.po",
+
+    #
+    # Translation files path
+    #
+    "translation": "%original_path%/%locale%.po",
+  }
+]
+

crowdin-docs.yml

@@ -0,0 +1,44 @@
+#
+# 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"
+
+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",
+  }
+]
+

crowdin.yml

@@ -1,63 +0,0 @@
-#
-# 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",
-  },
-  {
-    #
-    # 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",
-  }
-]

eslint.config.mjs

@@ -75,10 +75,6 @@ export default [
               sourceTag: 'scope:frontend',
               onlyDependOnLibsWithTags: ['scope:shared', 'scope:frontend'],
             },
-            {
-              sourceTag: 'scope:zapier',
-              onlyDependOnLibsWithTags: ['scope:shared'],
-            },
           ],
         },
       ],
@@ -141,10 +137,10 @@ export default [
       '@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': [
+      '@typescript-eslint/no-empty-object-type': [
         'error',
         {
-          allowSingleExtends: true,
+          allowInterfaces: 'with-single-extends',
         },
       ],
       '@typescript-eslint/no-explicit-any': 'off',

eslint.config.react.mjs

@@ -128,6 +128,375 @@ export default [
           additionalHooks: 'useRecoilCallback',
         },
       ],
+      // Lingui - detect untranslated strings
+      'lingui/no-unlocalized-strings': [
+        'error',
+        {
+          ignore: [
+            // Ignore strings which are a single "word" (no spaces) and don't start with uppercase
+            '^(?![A-Z])\\S+$',
+            // Ignore UPPERCASE literals (constants, env vars)
+            '^[A-Z0-9_-]+$',
+            // Ignore strings that look like code/technical (contain special chars)
+            '^[\\s]*$', // whitespace only
+            '.*[{}/<>].*', // contains code-like characters
+            '^\\d+(\\.\\d+)?(px|rem|em|%|vh|vw|s|ms)?$', // CSS units
+            '^[\\d.]+(px|rem|em|%|vh|vw|fr|s|ms)?(\\s+[\\d.]+(px|rem|em|%|vh|vw|fr|s|ms)?)*$', // CSS values like "200px 1fr 20px"
+            '^#[0-9a-fA-F]{3,8}$', // hex colors
+            '^rgba?\\(.*\\)$', // rgb/rgba colors
+            '^(auto|none|inherit|initial|unset|flex|grid|block|inline|inline-block|relative|absolute|fixed|sticky)$', // CSS keywords
+            '^color:.*$', // CSS color declarations
+            '^font-.*$', // CSS font declarations
+            '^\\d+$', // numbers only
+            '^https?:\\/\\/.*', // URLs
+            '^@.*', // @ mentions or decorators
+            '^\\/.*', // paths starting with /
+            '^[HhMmSsYyDdAaPp:.,\\s-]+$', // date format patterns (HH:mm, yyyy-MM-dd, etc.)
+            '^Arrow(Up|Down|Left|Right)$', // keyboard keys
+            '^(Enter|Escape|Tab|Space|Backspace|Delete)$', // keyboard keys
+            '^Text$', // clipboard data type
+            '^(allow-|sandbox)', // iframe sandbox values
+            '^Id$', // technical identifier suffix (e.g., fieldNameId)
+            '^(string|number|boolean|void|any|unknown|never|object)$', // TypeScript type keywords
+            '^(Dark|Light)$', // color schemes
+            '^translate\\(.*\\)$', // CSS transform strings
+            '^svg .*$', // CSS selectors
+            '^Icon[A-Z]\\w*$', // Icon names like IconDefault, IconTable, IconSettings
+            '^\\w*Icon$', // Icon names that end with Icon like FieldIcon
+            '^%c.*$', // Console format strings
+            // Common item IDs for selectable lists
+            '^(Group|CalendarView|CalendarDateField|Compact view)$',
+            '^(Layout|Visibility|Fields|Delete view|Copy link to view|Create custom view)$',
+            '^(GroupBy|Sort|HideEmptyGroups|HiddenGroups)$',
+            // HTTP headers and auth (technical, not user-facing)
+            '^Authorization$',
+            '^Bearer .*',
+            // Allow object keys that are technical identifiers
+            '^(topLeft|topRight|bottomLeft|bottomRight)$',
+            // Color schemes and CSS media queries
+            '^System$',
+            '^\\(prefers-color-scheme:',
+            // GraphQL query names (used in refetchQueries)
+            '^Get[A-Z]\\w*$',
+            // React Context names (technical identifiers)
+            '.*Context$',
+            // SVG paths (geometric coordinates, not translatable)
+            '^M[0-9 LML]+$',
+            '^[ML][0-9 ]+$',
+            // Database ordering values (technical, backend API)
+            '^(Asc|Desc)Nulls(First|Last)$',
+            // Calendar response status values (backend enum values, not user-facing)
+            '^(Yes|No|Maybe)$',
+            // Email validation error prefixes (combined with dynamic content)
+            '^Invalid email(s)?:',
+            // GraphQL type construction patterns
+            '.*FilterInput$',
+            '.*OrderByInput.*',
+            '^\\$filter.*',
+            '^\\$orderBy.*',
+            '^\\$after.*',
+            '^\\$before.*',
+            '^\\$first.*',
+            '^\\$last.*',
+            // Logger names (technical identifiers)
+            '^Twenty(-\\w+)?$',
+            // Cookie names and cookie string patterns
+            '^twenty_session_id$',
+            '^; domain=',
+            // Context names for createRequiredContext
+            '^[A-Z][a-zA-Z]+$',
+            // JSON-like filter patterns
+            '^%"type":',
+            '^%"objectNameSingular":',
+          ],
+          ignoreNames: [
+            // HTML/React attributes that shouldn't be translated
+            { regex: { pattern: 'className', flags: 'i' } },
+            { regex: { pattern: 'styleName', flags: 'i' } },
+            { regex: { pattern: 'testId', flags: 'i' } },
+            'data-testid',
+            'dataTestId',
+            'src',
+            'srcSet',
+            'href',
+            'target',
+            'rel',
+            'type',
+            'id',
+            'key',
+            'name',
+            'htmlFor',
+            'width',
+            'height',
+            'fill',
+            'stroke',
+            'viewBox',
+            'clipPath',
+            'd', // SVG path
+            'transform',
+            'displayName',
+            'defaultValue',
+            'to', // router links
+            'path',
+            'pathname',
+            'hash',
+            'componentInstanceId',
+            'hotkeyScope',
+            'dropdownId',
+            'recoilScopeId',
+            'modalId',
+            'dialogId',
+            'itemId',
+            'selectableItemIdArray',
+            'listenerId',
+            'focusId',
+            'color', // color prop values
+            'variant', // component variants
+            'size', // size prop values
+            'position', // position values
+            'align', // alignment values
+            'justify', // justification values
+            'direction', // direction values
+            'orientation', // orientation values
+            'status', // status values
+            'state', // state values
+            'mode', // mode values
+            'accent', // accent values
+
+            // CSS-related props
+            'gridAutoColumns',
+            'gridAutoRows',
+            'gridTemplateColumns',
+            'gridTemplateRows',
+            'gridColumn',
+            'gridRow',
+            'gap',
+            'margin',
+            'padding',
+            'border',
+            'borderRadius',
+            'boxShadow',
+            'flex',
+            'flexDirection',
+            'flexWrap',
+            'justifyContent',
+            'alignItems',
+            'alignContent',
+            'overflow',
+            'display',
+            'cursor',
+            'zIndex',
+            'opacity',
+            'fontWeight',
+            'fontSize',
+            'lineHeight',
+            'textAlign',
+            'textDecoration',
+            'whiteSpace',
+            'wordBreak',
+            'objectFit',
+            'backgroundSize',
+            'backgroundPosition',
+            'minWidth',
+            'maxWidth',
+            'minHeight',
+            'maxHeight',
+            'mobileGridAutoColumns',
+            'tabletGridAutoColumns',
+
+            // Styled components
+            'css',
+            'theme',
+            'animation',
+            'transition',
+
+            // GraphQL
+            'query',
+            'mutation',
+            'subscription',
+            'fragment',
+            'operationName',
+            'variables',
+            '__typename',
+
+            // Technical identifiers
+            'fieldName',
+            'columnName',
+            'objectNameSingular',
+            'objectNamePlural',
+            'metadataId',
+            'nameSingular',
+            'namePlural',
+
+            // Event types
+            'eventName',
+            'event',
+            'action',
+            'actionType',
+
+            // Icon names
+            'iconName',
+            { regex: { pattern: '^Icon[A-Z]' } },
+
+            // UPPER_CASE names (constants)
+            { regex: { pattern: '^[A-Z][A-Z0-9_]*$' } },
+
+            // Sort direction values (backend API)
+            'orderBy',
+            { regex: { pattern: '^(Asc|Desc)(NullsFirst|NullsLast)?$' } },
+
+            // HTTP headers (technical, not user-facing)
+            'Authorization',
+          ],
+          ignoreFunctions: [
+            // Console and logging
+            'console.*',
+            '*.log',
+            '*.warn',
+            '*.error',
+            '*.debug',
+            '*.info',
+            '*.trace',
+            'logDebug',
+            'formatTitle',
+
+            // Error handling (technical messages, not user-facing)
+            'Error',
+            'TypeError',
+            'RangeError',
+            'SyntaxError',
+            'throw',
+            'assertUnreachable',
+            'CustomError',
+            'parseInitialBlocknote',
+
+            // Testing
+            'describe',
+            'it',
+            'test',
+            'expect',
+            'jest.*',
+            '*.toBe',
+            '*.toEqual',
+            '*.toContain',
+            '*.toMatch',
+            '*.toThrow',
+
+            // React/Libraries internals
+            'require',
+            'import',
+            'styled',
+            'styled.*',
+            'css',
+            'keyframes',
+            'createGlobalStyle',
+
+            // Router
+            'useNavigate',
+            'navigate',
+            'useLocation',
+            'useParams',
+
+            // Date formatting (patterns are not translatable)
+            'format',
+            'formatDate',
+            'formatDateTime',
+            'formatTime',
+            'parseISO',
+            'parse',
+
+            // Navigation
+            'useNavigationSection',
+
+            // Recoil
+            'atom',
+            'atomFamily',
+            'selector',
+            'selectorFamily',
+            'useSetRecoilState',
+            'useRecoilState',
+            'useRecoilValue',
+
+            // GraphQL operations
+            'gql',
+            'useQuery',
+            'useMutation',
+            'useLazyQuery',
+            'useSubscription',
+
+            // Type checking and validation
+            '*.includes',
+            '*.indexOf',
+            '*.startsWith',
+            '*.endsWith',
+            '*.split',
+            '*.join',
+            '*.match',
+            '*.replace',
+            '*.test',
+            'Object.keys',
+            'Object.values',
+            'Object.entries',
+            'Array.isArray',
+
+            // DOM operations
+            '*.getElementById',
+            '*.getElementsByClassName',
+            '*.querySelector',
+            '*.querySelectorAll',
+            '*.getAttribute',
+            '*.setAttribute',
+            '*.addEventListener',
+            '*.removeEventListener',
+            '*.dispatchEvent',
+            '*.createElement',
+
+            // Storage
+            'localStorage.*',
+            'sessionStorage.*',
+            'searchParams.*',
+            '*.get',
+            '*.set',
+            '*.has',
+            '*.delete',
+
+            // Misc utilities
+            'cva',
+            'cn',
+            'clsx',
+            'classNames',
+            'track',
+            '*.postMessage',
+            '*.dispatch',
+            '*.commit',
+
+            // Event handlers (typically receive enum values, not user-facing text)
+            'onChange',
+            'onClick',
+            'onSelect',
+            'onSubmit',
+            'onFocus',
+            'onBlur',
+            'onKeyDown',
+            'onKeyUp',
+            'onMouseEnter',
+            'onMouseLeave',
+
+            // Logging functions (technical messages, not user-facing)
+            'logError',
+            'logDebug',
+            'logInfo',
+            'logWarn',
+            'loggerLink',
+
+            // Context creation (technical names)
+            'createRequiredContext',
+
+            // GraphQL refetch queries (technical identifiers)
+            'refetchQueries',
+          ],
+        },
+      ],
     },
   },
 
@@ -152,6 +521,10 @@ export default [
         'error',
         {
           patterns: [
+            {
+              group: ['../*'],
+              message: 'Relative parent imports are not allowed. Use @/ alias instead.',
+            },
             {
               group: ['@tabler/icons-react'],
               message: 'Please import icons from `twenty-ui`',
@@ -175,7 +548,7 @@ export default [
       '@typescript-eslint/ban-ts-comment': 'error',
       '@typescript-eslint/consistent-type-imports': [
         'error',
-        { 
+        {
           prefer: 'type-imports',
           fixStyle: 'inline-type-imports'
         },
@@ -183,10 +556,10 @@ export default [
       '@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': [
+      '@typescript-eslint/no-empty-object-type': [
         'error',
         {
-          allowSingleExtends: true,
+          allowInterfaces: 'with-single-extends',
         },
       ],
       '@typescript-eslint/no-empty-function': 'off',
@@ -208,14 +581,119 @@ export default [
     },
   },
 
-  // Storybook files
+  // Storybook files and story-related files
   {
-    files: ['*.stories.@(ts|tsx|js|jsx)'],
+    files: [
+      '**/*.stories.ts',
+      '**/*.stories.tsx',
+      '**/*.stories.js',
+      '**/*.stories.jsx',
+      '**/__stories__/**/*',
+    ],
     rules: {
       '@typescript-eslint/no-non-null-assertion': 'off',
+      'lingui/no-unlocalized-strings': 'off',
     },
   },
 
+  // Debug files - development only, not user-facing
+  {
+    files: [
+      '**/Debug*.tsx',
+      '**/*Debug*.tsx',
+      '**/*DebugDisplay*.tsx',
+      '**/*DebugHelper*.tsx',
+      '**/*DebugObserver*.tsx',
+    ],
+    rules: {
+      'lingui/no-unlocalized-strings': 'off',
+    },
+  },
+
+  // Testing utilities and mock data - not user-facing
+  {
+    files: [
+      '**/testing/**/*.tsx',
+      '**/testing/**/*.ts',
+      '**/__mocks__/**/*',
+      '**/*mock*.ts',
+      '**/*Mock*.ts',
+      '**/perf/**/*',
+    ],
+    rules: {
+      'lingui/no-unlocalized-strings': 'off',
+    },
+  },
+
+  // Constants files - technical values, not user-facing
+  {
+    files: [
+      '**/constants/**/*.ts',
+      '**/*.constants.ts',
+      '**/validation-schemas/**/*.ts',
+      '**/*Schema.ts',
+      '**/*-schema.ts',
+    ],
+    rules: {
+      'lingui/no-unlocalized-strings': 'off',
+    },
+  },
+
+  // Layout configuration files - titles are translated at consumption time
+  {
+    files: ['**/layouts/**/*.ts'],
+    rules: {
+      'lingui/no-unlocalized-strings': 'off',
+    },
+  },
+
+  // Service files - contain technical strings (logger names, HTTP headers, etc.)
+  {
+    files: ['**/services/**/*.ts'],
+    rules: {
+      'lingui/no-unlocalized-strings': 'off',
+    },
+  },
+
+  // State files - contain technical default values
+  {
+    files: ['**/states/**/*.ts'],
+    rules: {
+      'lingui/no-unlocalized-strings': 'off',
+    },
+  },
+
+  // Utility files - technical/developer-facing
+  {
+    files: [
+      '**/utils/**/*.ts',
+      '**/*Utils.ts',
+      '**/*-utils.ts',
+      '**/*Util.ts',
+      '**/*-util.ts',
+      '**/errors/**/*.ts',
+      '**/*Error.ts',
+      '**/*-error.ts',
+    ],
+    rules: {
+      'lingui/no-unlocalized-strings': 'off',
+    },
+  },
+
+  // Config and setup files - not user-facing
+  {
+    files: [
+      '**/*.config.ts',
+      '**/*.config.js',
+      '**/vite.config.ts',
+      '**/.storybook/**/*',
+    ],
+    rules: {
+      'lingui/no-unlocalized-strings': 'off',
+    },
+  },
+
+
   // JavaScript specific configuration
   {
     files: ['*.{js,jsx}'],
@@ -250,7 +728,18 @@ export default [
   // Test files
   {
     files: [
-      '*.test.@(ts|tsx|js|jsx)',
+      '**/*.test.ts',
+      '**/*.test.tsx',
+      '**/*.test.js',
+      '**/*.test.jsx',
+      '**/*.spec.ts',
+      '**/*.spec.tsx',
+      '**/*.spec.js',
+      '**/*.spec.jsx',
+      '**/__tests__/**/*.ts',
+      '**/__tests__/**/*.tsx',
+      '**/__mocks__/**/*.ts',
+      '**/__mocks__/**/*.tsx',
     ],
     languageOptions: {
       globals: {
@@ -266,6 +755,7 @@ export default [
     },
     rules: {
       '@typescript-eslint/no-non-null-assertion': 'off',
+      'lingui/no-unlocalized-strings': 'off',
     },
   },
 

nx.json

@@ -4,7 +4,9 @@
     "libsDir": "packages"
   },
   "namedInputs": {
-    "default": ["{projectRoot}/**/*"],
+    "default": [
+      "{projectRoot}/**/*"
+    ],
     "excludeStories": [
       "default",
       "!{projectRoot}/.storybook/*",
@@ -32,17 +34,26 @@
   "targetDefaults": {
     "build": {
       "cache": true,
-      "inputs": ["^production", "production"],
-      "dependsOn": ["^build"]
+      "inputs": [
+        "^production",
+        "production"
+      ],
+      "dependsOn": [
+        "^build"
+      ]
     },
     "start": {
       "cache": false,
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "lint": {
       "executor": "@nx/eslint:lint",
       "cache": true,
-      "outputs": ["{options.outputFile}"],
+      "outputs": [
+        "{options.outputFile}"
+      ],
       "options": {
         "eslintConfig": "{projectRoot}/eslint.config.mjs",
         "cache": true,
@@ -56,7 +67,22 @@
           "fix": true
         }
       },
-      "dependsOn": ["^build"]
+      "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",
@@ -77,7 +103,9 @@
           "write": true
         }
       },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "typecheck": {
       "executor": "nx:run-commands",
@@ -91,22 +119,30 @@
           "watch": true
         }
       },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "test": {
       "executor": "@nx/jest:jest",
       "cache": true,
-      "dependsOn": ["^build"],
+      "dependsOn": [
+        "^build"
+      ],
       "inputs": [
         "^default",
         "excludeStories",
         "{workspaceRoot}/jest.preset.js"
       ],
-      "outputs": ["{projectRoot}/coverage"],
+      "outputs": [
+        "{projectRoot}/coverage"
+      ],
       "options": {
         "jestConfig": "{projectRoot}/jest.config.mjs",
         "coverage": true,
-        "coverageReporters": ["text-summary"],
+        "coverageReporters": [
+          "text-summary"
+        ],
         "cacheDirectory": "../../.cache/jest/{projectRoot}"
       },
       "configurations": {
@@ -115,7 +151,10 @@
           "maxWorkers": 3
         },
         "coverage": {
-          "coverageReporters": ["lcov", "text"]
+          "coverageReporters": [
+            "lcov",
+            "text"
+          ]
         },
         "watch": {
           "watch": true
@@ -124,25 +163,36 @@
     },
     "test:e2e": {
       "cache": true,
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "storybook:build": {
       "executor": "nx:run-commands",
       "cache": true,
-      "inputs": ["^default", "excludeTests"],
-      "outputs": ["{projectRoot}/{options.output-dir}"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
+      "outputs": [
+        "{projectRoot}/{options.output-dir}"
+      ],
       "options": {
         "cwd": "{projectRoot}",
-        "command": "VITE_DISABLE_TYPESCRIPT_CHECKER=true storybook build --test",
+        "command": "NODE_OPTIONS='--max-old-space-size=10240' VITE_DISABLE_TYPESCRIPT_CHECKER=true storybook build --test",
         "output-dir": "storybook-static",
         "config-dir": ".storybook"
       },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "storybook:serve:dev": {
       "executor": "nx:run-commands",
       "cache": true,
-      "dependsOn": ["^build"],
+      "dependsOn": [
+        "^build"
+      ],
       "options": {
         "cwd": "{projectRoot}",
         "command": "storybook dev",
@@ -151,7 +201,9 @@
     },
     "storybook:serve:static": {
       "executor": "nx:run-commands",
-      "dependsOn": ["storybook:build"],
+      "dependsOn": [
+        "storybook:build"
+      ],
       "options": {
         "cwd": "{projectRoot}",
         "command": "npx http-server {args.staticDir} -a={args.host} --port={args.port} --silent={args.silent}",
@@ -164,8 +216,13 @@
     "storybook:test": {
       "executor": "nx:run-commands",
       "cache": true,
-      "inputs": ["^default", "excludeTests"],
-      "outputs": ["{projectRoot}/coverage/storybook"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
+      "outputs": [
+        "{projectRoot}/coverage/storybook"
+      ],
       "options": {
         "cwd": "{projectRoot}",
         "commands": [
@@ -181,7 +238,10 @@
     },
     "storybook:test:no-coverage": {
       "executor": "nx:run-commands",
-      "inputs": ["^default", "excludeTests"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
       "options": {
         "cwd": "{projectRoot}",
         "commands": [
@@ -271,12 +331,20 @@
     },
     "@nx/vite:test": {
       "cache": true,
-      "inputs": ["default", "^default"]
+      "inputs": [
+        "default",
+        "^default"
+      ]
     },
     "@nx/vite:build": {
       "cache": true,
-      "dependsOn": ["^build"],
-      "inputs": ["default", "^default"]
+      "dependsOn": [
+        "^build"
+      ],
+      "inputs": [
+        "default",
+        "^default"
+      ]
     }
   },
   "installation": {
@@ -308,7 +376,9 @@
   "tasksRunnerOptions": {
     "default": {
       "options": {
-        "cacheableOperations": ["storybook:build"]
+        "cacheableOperations": [
+          "storybook:build"
+        ]
       }
     }
   },

package.json

@@ -2,7 +2,6 @@
   "private": true,
   "dependencies": {
     "@apollo/client": "^3.7.17",
-    "@date-fns/tz": "^1.4.1",
     "@emotion/react": "^11.11.1",
     "@emotion/styled": "^11.11.0",
     "@floating-ui/react": "^0.24.3",
@@ -54,6 +53,7 @@
     "semver": "^7.5.4",
     "slash": "^5.1.0",
     "storybook-addon-mock-date": "^0.6.0",
+    "temporal-polyfill": "^0.3.0",
     "ts-key-enum": "^2.0.12",
     "tslib": "^2.8.1",
     "type-fest": "4.10.1",
@@ -82,20 +82,20 @@
     "@nx/vite": "22.0.3",
     "@nx/web": "22.0.3",
     "@sentry/types": "^8",
-    "@storybook/addon-actions": "8.6.14",
+    "@storybook/addon-actions": "8.6.15",
     "@storybook/addon-coverage": "^1.0.0",
-    "@storybook/addon-essentials": "8.6.14",
-    "@storybook/addon-interactions": "8.6.14",
-    "@storybook/addon-links": "8.6.14",
-    "@storybook/blocks": "8.6.14",
-    "@storybook/core-server": "8.6.14",
+    "@storybook/addon-essentials": "8.6.15",
+    "@storybook/addon-interactions": "8.6.15",
+    "@storybook/addon-links": "8.6.15",
+    "@storybook/blocks": "8.6.15",
+    "@storybook/core-server": "8.6.15",
     "@storybook/icons": "^1.2.9",
-    "@storybook/preview-api": "8.6.14",
-    "@storybook/react": "8.6.14",
-    "@storybook/react-vite": "8.6.14",
-    "@storybook/test": "8.6.14",
+    "@storybook/preview-api": "8.6.15",
+    "@storybook/react": "8.6.15",
+    "@storybook/react-vite": "8.6.15",
+    "@storybook/test": "8.6.15",
     "@storybook/test-runner": "^0.23.0",
-    "@storybook/types": "8.6.14",
+    "@storybook/types": "8.6.15",
     "@stylistic/eslint-plugin": "^1.5.0",
     "@swc-node/register": "1.8.0",
     "@swc/cli": "^0.3.12",
@@ -178,7 +178,7 @@
     "raw-loader": "^4.0.2",
     "rimraf": "^5.0.5",
     "source-map-support": "^0.5.20",
-    "storybook": "8.6.14",
+    "storybook": "8.6.15",
     "storybook-addon-cookie": "^3.2.0",
     "storybook-addon-pseudo-states": "^2.1.2",
     "supertest": "^6.1.3",

packages/create-twenty-app/README.md

@@ -23,6 +23,7 @@ Create Twenty App is the official scaffolding CLI for building apps on top of [T
 - 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

packages/create-twenty-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-twenty-app",
-  "version": "0.2.0",
+  "version": "0.2.4",
   "description": "Command-line interface to create Twenty application",
   "main": "dist/cli.cjs",
   "bin": "dist/cli.cjs",

packages/create-twenty-app/src/constants/base-application/eslint.config.mjs

@@ -1,137 +1,29 @@
 import js from '@eslint/js';
-import typescriptEslint from '@typescript-eslint/eslint-plugin';
-import typescriptParser from '@typescript-eslint/parser';
-import importPlugin from 'eslint-plugin-import';
-import preferArrowPlugin from 'eslint-plugin-prefer-arrow';
-import prettierPlugin from 'eslint-plugin-prettier';
-import unusedImportsPlugin from 'eslint-plugin-unused-imports';
+import tseslint from 'typescript-eslint';
 
 export default [
-  // Base JS rules
+  // Base JS recommended rules
   js.configs.recommended,
 
-  // Global ignores
-  {
-    ignores: ['**/node_modules/**', '**/dist/**', '**/coverage/**'],
-  },
+  // TypeScript recommended rules
+  ...tseslint.configs.recommended,
 
-  // Base config for TS/JS files
   {
-    files: ['**/*.{js,jsx,ts,tsx}'],
+    files: ['**/*.ts', '**/*.tsx'],
     languageOptions: {
-      ecmaVersion: 'latest',
-      sourceType: 'module',
-    },
-    plugins: {
-      prettier: prettierPlugin,
-      import: importPlugin,
-      'prefer-arrow': preferArrowPlugin,
-      'unused-imports': unusedImportsPlugin,
-    },
-    rules: {
-      // General rules (aligned with main project)
-      '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',
-
-      // 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: '^_',
-        },
-      ],
-
-      // Prettier (formatting as lint errors if you want)
-      'prettier/prettier': 'error',
-    },
-  },
-
-  // TypeScript-specific configuration
-  {
-    files: ['**/*.{ts,tsx}'],
-    languageOptions: {
-      parser: typescriptParser,
       parserOptions: {
-        ecmaFeatures: {
-          jsx: true,
-        },
+        project: true,
+        tsconfigRootDir: import.meta.dirname,
       },
     },
-    plugins: {
-      '@typescript-eslint': typescriptEslint,
-    },
     rules: {
-      // Turn off base rule and use TS-aware versions
-      'no-redeclare': 'off',
-      '@typescript-eslint/no-redeclare': 'error',
-
-      '@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-interface': [
-        'error',
-        {
-          allowSingleExtends: true,
-        },
+      // Common TypeScript-friendly tweaks
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        { argsIgnorePattern: '^_' },
       ],
       '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/no-empty-function': 'off',
-      '@typescript-eslint/no-unused-vars': 'off',
-    },
-  },
-
-  // Test files (Jest)
-  {
-    files: ['**/*.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',
+      'no-unused-vars': 'off', // handled by TS rule
     },
   },
 ];

packages/create-twenty-app/src/utils/app-template.ts

@@ -2,6 +2,8 @@ import * as fs from 'fs-extra';
 import { join } from 'path';
 import { v4 } from 'uuid';
 
+const SOURCE_FOLDER = 'src';
+
 export const copyBaseApplicationProject = async ({
   appName,
   appDisplayName,
@@ -21,10 +23,23 @@ export const copyBaseApplicationProject = async ({
 
   await createYarnLock(appDirectory);
 
+  const sourceFolderPath = join(appDirectory, SOURCE_FOLDER);
+
+  await fs.ensureDir(sourceFolderPath);
+
+  const defaultServerlessFunctionRoleUniversalIdentifier = v4();
+
+  await createDefaultServerlessFunctionRoleConfig({
+    displayName: appDisplayName,
+    appDirectory: sourceFolderPath,
+    defaultServerlessFunctionRoleUniversalIdentifier,
+  });
+
   await createApplicationConfig({
     displayName: appDisplayName,
     description: appDescription,
-    appDirectory,
+    appDirectory: sourceFolderPath,
+    defaultServerlessFunctionRoleUniversalIdentifier,
   });
 };
 
@@ -76,14 +91,41 @@ yarn-error.log*
   await fs.writeFile(join(appDirectory, '.gitignore'), gitignoreContent);
 };
 
+const createDefaultServerlessFunctionRoleConfig = async ({
+  displayName,
+  appDirectory,
+  defaultServerlessFunctionRoleUniversalIdentifier,
+}: {
+  displayName: string;
+  appDirectory: string;
+  defaultServerlessFunctionRoleUniversalIdentifier: string;
+}) => {
+  const content = `import { type RoleConfig } from 'twenty-sdk';
+
+export const functionRole: RoleConfig = {
+  universalIdentifier: '${defaultServerlessFunctionRoleUniversalIdentifier}',
+  label: '${displayName} default function role',
+  description: '${displayName} default function role',
+  canReadAllObjectRecords: true,
+  canUpdateAllObjectRecords: true,
+  canSoftDeleteAllObjectRecords: true,
+  canDestroyAllObjectRecords: false,
+};
+`;
+
+  await fs.writeFile(join(appDirectory, 'role.config.ts'), content);
+};
+
 const createApplicationConfig = async ({
   displayName,
   description,
   appDirectory,
+  defaultServerlessFunctionRoleUniversalIdentifier,
 }: {
   displayName: string;
   description?: string;
   appDirectory: string;
+  defaultServerlessFunctionRoleUniversalIdentifier: string;
 }) => {
   const content = `import { type ApplicationConfig } from 'twenty-sdk';
 
@@ -91,6 +133,7 @@ const config: ApplicationConfig = {
   universalIdentifier: '${v4()}',
   displayName: '${displayName}',
   description: '${description ?? ''}',
+  functionRoleUniversalIdentifier: '${defaultServerlessFunctionRoleUniversalIdentifier}',
 };
 
 export default config;
@@ -125,13 +168,17 @@ const createPackageJson = async ({
       uninstall: 'twenty app uninstall',
       help: 'twenty help',
       auth: 'twenty auth login',
+      lint: 'eslint',
+      'lint-fix': 'eslint --fix',
     },
     dependencies: {
-      'twenty-sdk': '0.2.0',
+      'twenty-sdk': '0.2.4',
     },
     devDependencies: {
-      '@types/node': '^24.7.2',
       typescript: '^5.9.3',
+      '@types/node': '^24.7.2',
+      eslint: '^9.32.0',
+      'typescript-eslint': '^8.50.0',
     },
   };
 

packages/twenty-apps/community/last-email-interaction/README.md

@@ -3,19 +3,21 @@
 Updates Last interaction and Interaction status fields based on last email date
 
 ## Requirements
-- twenty-cli `npm install -g twenty-cli`
-- an `apiKey`. Go to `https://twenty.com/settings/api-webhooks` to generate one
+- an `apiKey` - go to Settings > API & Webhooks to generate one
 
 ## Setup
 1. Add and synchronize app
 ```bash
-twenty auth login
-cd last_email_interaction
-twenty app sync
+cd packages/twenty-apps/community/last-email-interaction
+yarn auth
+yarn sync
 ```
 2. Go to Settings > Integrations > Last email interaction > Settings and add required variables
 
 ## Flow
 - Checks if fields are created, if not, creates them on fly
 - Extracts the datetime of message and calculates the last interaction status
-- Fetches all users and companies connected to them and updates their Last interaction and Interaction status fields
+- Fetches all users and companies connected to them and updates their Last interaction and Interaction status fields
+
+## Todo:
+- update app with generated Twenty object once extending objects is possible

packages/twenty-apps/community/last-email-interaction/application.config.ts

@@ -1,10 +1,11 @@
-import { type ApplicationConfig } from 'twenty-sdk/application';
+import { type ApplicationConfig } from 'twenty-sdk';
 
 const config: ApplicationConfig = {
   universalIdentifier: '718ed9ab-53fc-49c8-8deb-0cff78ecf0d2',
   displayName: 'Last email interaction',
   description:
     'Updates Last interaction and Interaction status fields based on last received email',
+  icon: "IconMailFast",
   applicationVariables: {
     TWENTY_API_KEY: {
       universalIdentifier: 'aae3f523-4c1f-4805-b3ee-afeb676c381e',

packages/twenty-apps/community/last-email-interaction/package.json

@@ -10,9 +10,19 @@
   "packageManager": "yarn@4.9.2",
   "dependencies": {
     "axios": "^1.12.2",
-    "twenty-sdk": "0.0.4"
+    "twenty-sdk": "0.2.4"
   },
   "devDependencies": {
     "@types/node": "^24.7.2"
+  },
+  "scripts": {
+    "auth": "twenty auth login",
+    "generate": "twenty app generate",
+    "dev": "twenty app dev",
+    "sync": "twenty app sync",
+    "uninstall": "twenty app uninstall",
+    "logs": "twenty app logs",
+    "create-entity": "twenty app add",
+    "help": "twenty --help"
   }
 }

packages/twenty-apps/community/last-email-interaction/serverlessFunctions/test/src/index.ts

@@ -1,277 +0,0 @@
-import axios from 'axios';
-import { type ServerlessFunctionConfig } from 'twenty-sdk/application';
-
-const TWENTY_API_KEY = process.env.TWENTY_API_KEY ?? '';
-const TWENTY_URL =
-  process.env.TWENTY_API_URL !== '' && process.env.TWENTY_API_URL !== undefined
-    ? `${process.env.TWENTY_API_URL}/rest`
-    : 'https://api.twenty.com/rest';
-
-const create_last_interaction = (id: string) => {
-  return {
-    method: 'POST',
-    url: `${TWENTY_URL}/metadata/fields`,
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    data: {
-      type: 'DATE_TIME',
-      objectMetadataId: `${id}`,
-      name: 'lastInteraction',
-      label: 'Last interaction',
-      description: 'Date when the last interaction happened',
-      icon: 'IconCalendarClock',
-      defaultValue: null,
-      isNullable: true,
-      settings: {},
-    },
-  };
-};
-
-const create_interaction_status = (id: string) => {
-  return {
-    method: 'POST',
-    url: `${TWENTY_URL}/metadata/fields`,
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    data: {
-      type: 'SELECT',
-      objectMetadataId: `${id}`,
-      name: 'interactionStatus',
-      label: 'Interaction status',
-      description: 'Indicates the health of relation',
-      icon: 'IconProgress',
-      defaultValue: null,
-      isNullable: true,
-      settings: {},
-      options: [
-        {
-          color: 'green',
-          label: 'Recent',
-          value: 'RECENT',
-          position: 1,
-        },
-        {
-          color: 'yellow',
-          label: 'Active',
-          value: 'ACTIVE',
-          position: 2,
-        },
-        {
-          color: 'sky',
-          label: 'Cooling',
-          value: 'COOLING',
-          position: 3,
-        },
-        {
-          color: 'gray',
-          label: 'Dormant',
-          value: 'DORMANT',
-          position: 4,
-        },
-      ],
-    },
-  };
-};
-
-const calculateStatus = (date: string) => {
-  const day = 1000 * 60 * 60 * 24;
-  const now = Date.now();
-  const messageDate = Date.parse(date);
-  const deltaTime = now - messageDate;
-  return deltaTime < 7 * day
-    ? 'RECENT'
-    : deltaTime < 30 * day
-      ? 'ACTIVE'
-      : deltaTime < 90 * day
-        ? 'COOLING'
-        : 'DORMANT';
-};
-
-const interactionData = (date: string, status: string) => {
-  return {
-    lastInteraction: date,
-    interactionStatus: status,
-  };
-};
-
-const updateInteractionStatus = async (objectName: string, id: string, messageDate: string, status: string) => {
-  const options = {
-    method: 'PATCH',
-    url: `${TWENTY_URL}/${objectName}/${id}`,
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    data: {
-      lastInteraction: messageDate,
-      interactionStatus: status
-    }
-  };
-  try {
-    const response = await axios.request(options);
-    if (response.status === 200) {
-      console.log('Successfully updated company last interaction field');
-    }
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-    throw error;
-  }
-}
-
-const fetchRelatedCompanyId = async (id: string) => {
-  const options = {
-    method: 'GET',
-    url: `${TWENTY_URL}/people/${id}`,
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-  };
-  try {
-    const req = await axios.request(options);
-    if (req.status === 200 && req.data.person.companyId !== null && req.data.person.companyId !== undefined) {
-      return req.data.person.companyId;
-    }
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-    throw error;
-  }
-}
-
-export const main = async (params: {
-  properties: Record<string, any>;
-  recordId: string;
-  userId: string;
-}): Promise<object | undefined> => {
-  if (TWENTY_API_KEY === '') {
-    console.log("Function exited as API key or URL hasn't been set properly");
-    return {};
-  }
-  const { properties, recordId } = params;
-  // Check if fields are created
-  const options = {
-    method: 'GET',
-    url: `${TWENTY_URL}/metadata/objects`,
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-  };
-  try {
-    const response = await axios.request(options);
-    const objects = response.data.data.objects;
-    const company_object = objects.find(
-      (object: any) => object.nameSingular === 'company',
-    );
-    const company_last_interaction = company_object.fields.find(
-      (field: any) => field.name === 'lastInteraction',
-    );
-    const company_interaction_status = company_object.fields.find(
-      (field: any) => field.name === 'interactionStatus',
-    );
-    const person_object = objects.find(
-      (object: any) => object.nameSingular === 'person',
-    );
-    const person_last_interaction = person_object.fields.find(
-      (field: any) => field.name === 'lastInteraction',
-    );
-    const person_interaction_status = person_object.fields.find(
-      (field: any) => field.name === 'interactionStatus',
-    );
-    // If not, create them
-    if (company_last_interaction === undefined) {
-      const response2 = await axios.request(
-        create_last_interaction(company_object.id),
-      );
-      if (response2.status === 201) {
-        console.log('Successfully created company last interaction field');
-      }
-    }
-    if (company_interaction_status === undefined) {
-      const response2 = await axios.request(
-        create_interaction_status(company_object.id),
-      );
-      if (response2.status === 201) {
-        console.log('Successfully created company interaction status field');
-      }
-    }
-    if (person_last_interaction === undefined) {
-      const response2 = await axios.request(
-        create_last_interaction(person_object.id),
-      );
-      if (response2.status === 201) {
-        console.log('Successfully created person last interaction field');
-      }
-    }
-    if (person_interaction_status === undefined) {
-      const response2 = await axios.request(
-        create_interaction_status(person_object.id),
-      );
-      if (response2.status === 201) {
-        console.log('Successfully created person interaction status field');
-      }
-    }
-
-    // Extract the timestamp of message
-    const messageDate = properties.after.receivedAt;
-    const interactionStatus = calculateStatus(messageDate);
-
-    // Get the details of person and related company
-    const messageOptions = {
-      method: 'GET',
-      url: `${TWENTY_URL}/messages/${recordId}?depth=1`,
-      headers: {
-        Authorization: `Bearer ${TWENTY_API_KEY}`,
-      },
-    };
-    const messageDetails = await axios.request(messageOptions);
-    const peopleIds: string[] = [];
-    for (const participant of messageDetails.data.messages
-      .messageParticipants) {
-      peopleIds.push(participant.personId);
-    }
-
-    const companiesIds = [];
-    for (const id of peopleIds) {
-      companiesIds.push(await fetchRelatedCompanyId(id));
-    }
-    // Update the field value depending on the timestamp
-    for (const id of peopleIds) {
-     await updateInteractionStatus("people", id, messageDate, interactionStatus);
-    }
-
-    for (const id of companiesIds) {
-      await updateInteractionStatus("companies", id, messageDate, interactionStatus);
-    }
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      console.error(error.message);
-      return {};
-    }
-    console.error(error);
-    return {};
-  }
-};
-
-export const config: ServerlessFunctionConfig = {
-  universalIdentifier: '683966a0-b60a-424e-86b1-7448c9191bde',
-  name: 'test',
-  triggers: [
-    {
-      universalIdentifier: 'f4f1e127-87f0-4dcf-99fe-8061adf5cbe6',
-      type: 'databaseEvent',
-      eventName: 'message.created',
-    },
-    {
-      universalIdentifier: '4c17878f-b6b3-4d0a-8de6-967b1cb55002',
-      type: 'databaseEvent',
-      eventName: 'message.updated',
-    },
-  ],
-};

packages/twenty-apps/community/last-email-interaction/src/index.ts

@@ -0,0 +1,270 @@
+import axios from 'axios';
+import { type FunctionConfig } from 'twenty-sdk';
+
+const TWENTY_API_KEY = process.env.TWENTY_API_KEY ?? '';
+const TWENTY_URL =
+  process.env.TWENTY_API_URL !== '' && process.env.TWENTY_API_URL !== undefined
+    ? `${process.env.TWENTY_API_URL}/rest`
+    : 'https://api.twenty.com/rest';
+
+const create_last_interaction = (id: string) => {
+  return {
+    method: 'POST',
+    url: `${TWENTY_URL}/metadata/fields`,
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+    data: {
+      type: 'DATE_TIME',
+      objectMetadataId: `${id}`,
+      name: 'lastInteraction',
+      label: 'Last interaction',
+      description: 'Date when the last interaction happened',
+      icon: 'IconCalendarClock',
+      defaultValue: null,
+      isNullable: true,
+      settings: {},
+    },
+  };
+};
+
+const create_interaction_status = (id: string) => {
+  return {
+    method: 'POST',
+    url: `${TWENTY_URL}/metadata/fields`,
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+    data: {
+      type: 'SELECT',
+      objectMetadataId: `${id}`,
+      name: 'interactionStatus',
+      label: 'Interaction status',
+      description: 'Indicates the health of relation',
+      icon: 'IconProgress',
+      defaultValue: null,
+      isNullable: true,
+      settings: {},
+      options: [
+        {
+          color: 'green',
+          label: 'Recent',
+          value: 'RECENT',
+          position: 1,
+        },
+        {
+          color: 'yellow',
+          label: 'Active',
+          value: 'ACTIVE',
+          position: 2,
+        },
+        {
+          color: 'sky',
+          label: 'Cooling',
+          value: 'COOLING',
+          position: 3,
+        },
+        {
+          color: 'gray',
+          label: 'Dormant',
+          value: 'DORMANT',
+          position: 4,
+        },
+      ],
+    },
+  };
+};
+
+const calculateStatus = (date: string) => {
+  const day = 1000 * 60 * 60 * 24;
+  const now = Date.now();
+  const messageDate = Date.parse(date);
+  const deltaTime = now - messageDate;
+  return deltaTime < 7 * day
+    ? 'RECENT'
+    : deltaTime < 30 * day
+      ? 'ACTIVE'
+      : deltaTime < 90 * day
+        ? 'COOLING'
+        : 'DORMANT';
+};
+
+const updateInteractionStatus = async (objectName: string, id: string, messageDate: string, status: string) => {
+  const options = {
+    method: 'PATCH',
+    url: `${TWENTY_URL}/${objectName}/${id}`,
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+    data: {
+      lastInteraction: messageDate,
+      interactionStatus: status
+    }
+  };
+  try {
+    const response = await axios.request(options);
+    if (response.status === 200) {
+      console.log('Successfully updated company last interaction field');
+    }
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+    throw error;
+  }
+}
+
+const fetchRelatedCompanyId = async (id: string) => {
+  const options = {
+    method: 'GET',
+    url: `${TWENTY_URL}/people/${id}`,
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+  };
+  try {
+    const req = await axios.request(options);
+    if (req.status === 200 && req.data.person.companyId !== null && req.data.person.companyId !== undefined) {
+      return req.data.person.companyId;
+    }
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+    throw error;
+  }
+}
+
+export const main = async (params: {
+  properties: Record<string, any>;
+  recordId: string;
+  userId: string;
+}): Promise<object | undefined> => {
+  if (TWENTY_API_KEY === '') {
+    console.log("Function exited as API key or URL hasn't been set properly");
+    return {};
+  }
+  const { properties, recordId } = params;
+  // Check if fields are created
+  const options = {
+    method: 'GET',
+    url: `${TWENTY_URL}/metadata/objects`,
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+  };
+  try {
+    const response = await axios.request(options);
+    const objects = response.data.data.objects;
+    const company_object = objects.find(
+      (object: any) => object.nameSingular === 'company',
+    );
+    const company_last_interaction = company_object.fields.find(
+      (field: any) => field.name === 'lastInteraction',
+    );
+    const company_interaction_status = company_object.fields.find(
+      (field: any) => field.name === 'interactionStatus',
+    );
+    const person_object = objects.find(
+      (object: any) => object.nameSingular === 'person',
+    );
+    const person_last_interaction = person_object.fields.find(
+      (field: any) => field.name === 'lastInteraction',
+    );
+    const person_interaction_status = person_object.fields.find(
+      (field: any) => field.name === 'interactionStatus',
+    );
+    // If not, create them
+    if (company_last_interaction === undefined) {
+      const response2 = await axios.request(
+        create_last_interaction(company_object.id),
+      );
+      if (response2.status === 201) {
+        console.log('Successfully created company last interaction field');
+      }
+    }
+    if (company_interaction_status === undefined) {
+      const response2 = await axios.request(
+        create_interaction_status(company_object.id),
+      );
+      if (response2.status === 201) {
+        console.log('Successfully created company interaction status field');
+      }
+    }
+    if (person_last_interaction === undefined) {
+      const response2 = await axios.request(
+        create_last_interaction(person_object.id),
+      );
+      if (response2.status === 201) {
+        console.log('Successfully created person last interaction field');
+      }
+    }
+    if (person_interaction_status === undefined) {
+      const response2 = await axios.request(
+        create_interaction_status(person_object.id),
+      );
+      if (response2.status === 201) {
+        console.log('Successfully created person interaction status field');
+      }
+    }
+
+    // Extract the timestamp of message
+    const messageDate = properties.after.receivedAt;
+    const interactionStatus = calculateStatus(messageDate);
+
+    // Get the details of person and related company
+    const messageOptions = {
+      method: 'GET',
+      url: `${TWENTY_URL}/messages/${recordId}?depth=1`,
+      headers: {
+        Authorization: `Bearer ${TWENTY_API_KEY}`,
+      },
+    };
+    const messageDetails = await axios.request(messageOptions);
+    const peopleIds: string[] = [];
+    for (const participant of messageDetails.data.messages
+      .messageParticipants) {
+      peopleIds.push(participant.personId);
+    }
+
+    const companiesIds = [];
+    for (const id of peopleIds) {
+      companiesIds.push(await fetchRelatedCompanyId(id));
+    }
+    // Update the field value depending on the timestamp
+    for (const id of peopleIds) {
+     await updateInteractionStatus("people", id, messageDate, interactionStatus);
+    }
+
+    for (const id of companiesIds) {
+      await updateInteractionStatus("companies", id, messageDate, interactionStatus);
+    }
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      console.error(error.message);
+      return {};
+    }
+    console.error(error);
+    return {};
+  }
+};
+
+export const config: FunctionConfig = {
+  universalIdentifier: '683966a0-b60a-424e-86b1-7448c9191bde',
+  name: 'test',
+  triggers: [
+    {
+      universalIdentifier: 'f4f1e127-87f0-4dcf-99fe-8061adf5cbe6',
+      type: 'databaseEvent',
+      eventName: 'message.created',
+    },
+    {
+      universalIdentifier: '4c17878f-b6b3-4d0a-8de6-967b1cb55002',
+      type: 'databaseEvent',
+      eventName: 'message.updated',
+    },
+  ],
+};

packages/twenty-apps/community/linkedin-browser-extension/browser-extension/src/entrypoints/popup/app.tsx

@@ -12,19 +12,28 @@ function App() {
   useEffect(() => {
     browser.tabs.query({ active: true, currentWindow: true }, function(tabs) {
       const currentTab = tabs[0];
-      if(currentTab.url?.includes('https://www.linkedin.com/in')) {
-        sendMessage('getPersonviaRelay').then(data => {
-          setValue({...data, type: 'person' })
-        })
-       }
 
-      if(currentTab.url?.includes('https://www.linkedin.com/company')) {
-       sendMessage('getCompanyviaRelay').then(data => {
-         setValue({...data, type: 'company'})
-       })
+      if (!currentTab.url) {
+        return;
+      }
+
+      let url = new URL(currentTab.url);
+
+      const isLinkedinHost =
+        url.protocol === 'https:' && url.hostname === 'www.linkedin.com';
+
+      if (isLinkedinHost && url.pathname.startsWith('/in/')) {
+        sendMessage('getPersonviaRelay').then((data) => {
+          setValue({ ...data, type: 'person' });
+        });
+      }
+
+      if (isLinkedinHost && url.pathname.startsWith('/company/')) {
+        sendMessage('getCompanyviaRelay').then((data) => {
+          setValue({ ...data, type: 'company' });
+        });
       }
     });
-
   }, []);
 
   const isPersonValue = (val: Value): val is PersonValue => {
@@ -38,25 +47,29 @@ function App() {
   return (
     <StyledMain>
       <h1>{JSON.stringify(value)}</h1>
-      {
-      isPersonValue(value) &&
-      <button onClick={async () => {
-        await sendMessage('createPerson', {
-          firstName: value.firstName,
-          lastName: value.lastName,
-        });
-
-      }}>save person to twenty</button>
-    }
-    {
-      isCompanyValue(value) &&
-      <button onClick={async () => {
-        await sendMessage('createCompany', {
-          name: value.companyName
-        });
-
-      }}>save company to twenty</button>
-    }
+      {isPersonValue(value) && (
+        <button
+          onClick={async () => {
+            await sendMessage('createPerson', {
+              firstName: value.firstName,
+              lastName: value.lastName,
+            });
+          }}
+        >
+          save person to twenty
+        </button>
+      )}
+      {isCompanyValue(value) && (
+        <button
+          onClick={async () => {
+            await sendMessage('createCompany', {
+              name: value.companyName,
+            });
+          }}
+        >
+          save company to twenty
+        </button>
+      )}
     </StyledMain>
   );
 }

packages/twenty-apps/community/mailchimp-synchronizer/README.md

@@ -3,16 +3,15 @@
 Synchronizing contacts between Twenty and Mailchimp
 
 ## Requirements
-- twenty-cli `npm install -g twenty-cli`
-- an `apiKey`. Go to `https://twenty.com/settings/api-webhooks` to generate one
 - Mailchimp API key - Mailchimp > avatar in top right corner > Profile > Extras > API keys
 
 ## Setup
 1. Add app to your workspace
 ```bash
-twenty auth login
-cd mailchimp-synchronizer
-twenty app sync
+cd packages/twenty-apps/community/mailchimp-synchronizer
+yarn auth
+yarn generate
+yarn sync
 ```
 2. Go to Settings > Integrations > Mailchimp synchronizer > Settings and add required variables
 

packages/twenty-apps/community/mailchimp-synchronizer/application.config.ts

@@ -1,4 +1,4 @@
-import { type ApplicationConfig } from 'twenty-sdk/application';
+import { type ApplicationConfig } from 'twenty-sdk';
 
 const config: ApplicationConfig = {
   universalIdentifier: '1eadac4e-db9f-4cce-b20b-de75f41e34dc',
@@ -6,16 +6,6 @@ const config: ApplicationConfig = {
   description: 'Synchronizes Twenty contacts in Mailchimp',
   icon: "IconMailFast",
   applicationVariables: {
-    TWENTY_API_KEY: {
-      universalIdentifier: '0af17af3-66b8-40cf-b6e2-6a29a1da5464',
-      isSecret: true,
-      description: 'Required to send requests to Twenty',
-    },
-    TWENTY_API_URL: {
-      universalIdentifier: '12949c1c-aed7-4a9f-bd06-9fd15f0bfa63',
-      isSecret: false,
-      description: 'Optional, defaults to cloud API URL',
-    },
     MAILCHIMP_API_KEY: {
       universalIdentifier: 'f10d4e8a-8055-4eb2-b9ad-efd69d43b1f0',
       isSecret: true,

packages/twenty-apps/community/mailchimp-synchronizer/package.json

@@ -10,9 +10,19 @@
   "packageManager": "yarn@4.9.2",
   "dependencies": {
     "axios": "^1.13.2",
-    "twenty-sdk": "0.0.4"
+    "twenty-sdk": "0.2.4"
   },
   "devDependencies": {
     "@types/node": "^24.7.2"
+  },
+  "scripts": {
+    "auth": "twenty auth login",
+    "generate": "twenty app generate",
+    "dev": "twenty app dev",
+    "sync": "twenty app sync",
+    "uninstall": "twenty app uninstall",
+    "logs": "twenty app logs",
+    "create-entity": "twenty app add",
+    "help": "twenty --help"
   }
 }

packages/twenty-apps/community/mailchimp-synchronizer/serverlessFunctions/mailchimp/src/index.ts

@@ -1,454 +0,0 @@
-import axios from 'axios';
-import { type ServerlessFunctionConfig } from 'twenty-sdk/application';
-
-const TWENTY_API_URL: string =
-  process.env.TWENTY_API_URL !== '' && process.env.TWENTY_API_URL !== undefined
-    ? `${process.env.TWENTY_API_URL}/rest`
-    : 'https://api.twenty.com/rest';
-const TWENTY_API_KEY: string = process.env.TWENTY_API_KEY ?? '';
-const MAILCHIMP_API_URL: string =
-  process.env.MAILCHIMP_SERVER_PREFIX !== '' &&
-  process.env.MAILCHIMP_SERVER_PREFIX !== undefined
-    ? `https://${process.env.MAILCHIMP_SERVER_PREFIX}.api.mailchimp.com/3.0/`
-    : '';
-const MAILCHIMP_API_KEY: string = process.env.MAILCHIMP_API_KEY ?? '';
-const MAILCHIMP_AUDIENCE_ID: string = process.env.MAILCHIMP_AUDIENCE_ID ?? '';
-const IS_EMAIL_CONSTRAINT: boolean = process.env.IS_EMAIL_CONSTRAINT === 'true';
-const IS_COMPANY_CONSTRAINT: boolean =
-  process.env.COMPANY_CONSTRAINT === 'true';
-const IS_PHONE_CONSTRAINT: boolean = process.env.IS_PHONE_CONSTRAINT === 'true';
-const IS_ADDRESS_CONSTRAINT: boolean =
-  process.env.IS_ADDRESS_CONSTRAINT === 'true';
-const UPDATE_PERSON: boolean = process.env.UPDATE_PERSON === 'true';
-
-type mailchimpAddress = {
-  street1: string;
-  street2: string;
-  city: string;
-  state: string;
-  zipCode: string;
-  country: string;
-};
-
-type mailchimpRecord = {
-  id?: string;
-  email_channel?: {
-    email: string;
-    marketing_consent?: {
-      status: string;
-    };
-  };
-  sms_channel?: {
-    sms_phone: string;
-    marketing_consent?: {
-      status: string;
-    };
-  };
-  mergeFields: {
-    FNAME: string;
-    LNAME: string;
-    ADDRESS: string | mailchimpAddress;
-    COMPANY: string;
-    PHONE: string;
-  };
-};
-
-type twentyAddress = {
-  addressStreet1: string;
-  addressStreet2: string;
-  addressCity: string;
-  addressState: string;
-  addressPostCode: string;
-  addressCountry: string;
-};
-
-type twentyCompany = {
-  name: string;
-  address: twentyAddress;
-};
-
-type twentyPerson = {
-  name: {
-    firstName: string;
-    lastName: string;
-  };
-  emails: {
-    primaryEmail: string;
-  };
-  phones: {
-    primaryPhoneNumber: string;
-    primaryPhoneCallingCode: string;
-  };
-  companyId: string | null;
-};
-
-const fetchCompanyData = async (companyId: string): Promise<twentyCompany> => {
-  const options = {
-    method: 'GET',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    url: `${TWENTY_API_URL}/company/${companyId}`,
-  };
-  try {
-    const response = await axios.request(options);
-    return response.status === 200
-      ? ({
-          name: response.data.name as string,
-          address: response.data.address as twentyAddress,
-        } as twentyCompany)
-      : ({} as twentyCompany);
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-    throw error;
-  }
-};
-
-const checkAddress = (address: twentyAddress): mailchimpAddress => {
-  if (
-    address.addressStreet1 !== '' &&
-    address.addressCity !== '' &&
-    address.addressPostCode !== '' &&
-    address.addressState !== ''
-  ) {
-    return {
-      street1: address.addressStreet1,
-      street2: address.addressStreet2,
-      city: address.addressCity,
-      state: address.addressState,
-      zipCode: address.addressPostCode,
-      country: address.addressCountry,
-    } as mailchimpAddress;
-  }
-  throw new Error('Invalid address');
-};
-
-const checkAudiencePermissions = async (
-  audienceId: string,
-): Promise<string[] | undefined> => {
-  const options = {
-    method: 'GET',
-    headers: {
-      Authorization: `Bearer ${MAILCHIMP_API_KEY}`,
-    },
-    url: `${MAILCHIMP_API_URL}/audiences/${audienceId}`,
-  };
-  try {
-    const temp = await axios.request(options);
-    return temp.data.enabled_channels;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const prepareData = (
-  firstName: string,
-  lastName: string,
-  email: string,
-  phoneNumber: string,
-  phoneCallingCode: string,
-  companyName: string,
-  address: mailchimpAddress | string,
-): mailchimpRecord => {
-  let data = {
-    mergeFields: {},
-  } as mailchimpRecord;
-  data.mergeFields.FNAME = firstName;
-  data.mergeFields.LNAME = lastName;
-  if (IS_EMAIL_CONSTRAINT) {
-    data.email_channel = {
-      email: email,
-      marketing_consent: {
-        status: 'unknown',
-      },
-    };
-  }
-  if (IS_ADDRESS_CONSTRAINT) {
-    data.mergeFields.ADDRESS = address;
-  }
-  if (IS_PHONE_CONSTRAINT) {
-    const mergedPhoneNumber: string = phoneCallingCode.startsWith('+')
-      ? phoneCallingCode.concat(phoneNumber)
-      : '+'.concat(phoneCallingCode, phoneNumber);
-    data['sms_channel'] = {
-      sms_phone: mergedPhoneNumber,
-      marketing_consent: {
-        status: 'unknown',
-      },
-    };
-    data['mergeFields']['PHONE'] = mergedPhoneNumber;
-  }
-  if (IS_COMPANY_CONSTRAINT) {
-    data['mergeFields']['COMPANY'] = companyName;
-  }
-  return data;
-};
-
-const addTwentyPersonToMailchimp = async (
-  convertedRecord: mailchimpRecord,
-): Promise<boolean | undefined> => {
-  const options = {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${MAILCHIMP_API_KEY}`,
-    },
-    url: `${MAILCHIMP_API_URL}/audiences/${MAILCHIMP_AUDIENCE_ID}/contacts`,
-    data: convertedRecord,
-  };
-  try {
-    const response = await axios.request(options);
-    return response.status === 200;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const checkIfTwentyPersonExistsInMailchimp = async (
-  email?: string,
-  phoneNumber?: string,
-  cursor?: string,
-) => {
-  const options = {
-    method: 'GET',
-    headers: {
-      Authorization: `Bearer ${MAILCHIMP_API_KEY}`,
-    },
-    url: cursor
-      ? `${MAILCHIMP_API_URL}/audiences/${MAILCHIMP_AUDIENCE_ID}/contacts?count%3D1000%26cursor%3D${cursor}`
-      : `${MAILCHIMP_API_URL}/audiences/${MAILCHIMP_AUDIENCE_ID}/contacts?count%3D1000`,
-  };
-  try {
-    const response = await axios.request(options);
-    const doesPersonExist: mailchimpRecord | undefined =
-      (response.data.contacts.find(
-        (contact: any) => contact.email_channel.email === email,
-      ) as mailchimpRecord) ||
-      (response.data.contacts.find(
-        (contact: any) => contact.sms_channel.sms_phone === phoneNumber,
-      ) as mailchimpRecord);
-    if (doesPersonExist !== undefined) {
-      return doesPersonExist;
-    }
-    if (response.data.next_cursor === undefined) {
-      return undefined;
-    } else {
-      await checkIfTwentyPersonExistsInMailchimp(
-        email,
-        phoneNumber,
-        response.data.next_cursor,
-      );
-    }
-    return undefined;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const compareTwoRecords = (
-  object1: mailchimpRecord,
-  object2: mailchimpRecord,
-) => {
-  return (
-    object1.email_channel?.email === object2.email_channel?.email &&
-    object1.sms_channel?.sms_phone === object2.sms_channel?.sms_phone &&
-    object1.mergeFields.FNAME === object2.mergeFields.FNAME &&
-    object1.mergeFields.LNAME === object2.mergeFields.LNAME &&
-    object1.mergeFields.ADDRESS === object2.mergeFields.ADDRESS &&
-    object1.mergeFields.COMPANY === object2.mergeFields.COMPANY
-  );
-};
-
-const updateTwentyPersonInMailchimp = async (
-  mailchimpRecordId: string,
-  twentyConvertedRecord: mailchimpRecord,
-): Promise<boolean | undefined> => {
-  const options = {
-    method: 'PATCH',
-    headers: {
-      Authorization: `Bearer ${MAILCHIMP_API_KEY}`,
-      'Content-Type': 'application/json',
-    },
-    url: `${MAILCHIMP_API_URL}/audiences/${MAILCHIMP_AUDIENCE_ID}/contacts/${mailchimpRecordId}`,
-    data: twentyConvertedRecord,
-  };
-  try {
-    const response = await axios.request(options);
-    return response.status === 200;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-export const main = async (params: {
-  properties: Record<string, any>;
-  recordId: string;
-  userId: string;
-}): Promise<object | undefined> => {
-  if (!IS_EMAIL_CONSTRAINT && !IS_PHONE_CONSTRAINT) {
-    console.warn(
-      'Function exited as there are no constraints to email nor phone number',
-    );
-    return {};
-  }
-  if (
-    MAILCHIMP_API_URL === '' ||
-    MAILCHIMP_API_KEY === '' ||
-    MAILCHIMP_AUDIENCE_ID === ''
-  ) {
-    console.warn('Missing Mailchimp required parameters');
-    return {};
-  }
-  if (IS_COMPANY_CONSTRAINT && TWENTY_API_KEY === '') {
-    console.warn('Missing Twenty related parameters');
-    return {};
-  }
-
-  try {
-    const { properties } = params;
-    const twentyRecord: twentyPerson = properties.after as twentyPerson;
-    if (
-      twentyRecord.name.firstName === '' ||
-      twentyRecord.name.lastName === ''
-    ) {
-      throw new Error('First or last name is empty');
-    }
-
-    const audiencePermissions: string[] | undefined =
-      await checkAudiencePermissions(MAILCHIMP_AUDIENCE_ID);
-
-    if (
-      IS_EMAIL_CONSTRAINT &&
-      audiencePermissions?.includes('Email') &&
-      twentyRecord.emails.primaryEmail === ''
-    ) {
-      throw new Error('Email is empty');
-    }
-
-    if (
-      IS_PHONE_CONSTRAINT &&
-      audiencePermissions?.includes('SMS') &&
-      (twentyRecord.phones.primaryPhoneNumber === '' ||
-        twentyRecord.phones.primaryPhoneCallingCode === '')
-    ) {
-      throw new Error('Phone number is empty');
-    }
-
-    let companyName: string = '';
-    let address: mailchimpAddress | string = '';
-    if (IS_COMPANY_CONSTRAINT) {
-      if (twentyRecord.companyId === null) {
-        throw new Error('Missing relation to company record');
-      }
-      const company: twentyCompany = await fetchCompanyData(
-        twentyRecord.companyId,
-      );
-      companyName = company.name ?? ''; // either "" or name
-      address = IS_ADDRESS_CONSTRAINT ? checkAddress(company.address) : '';
-    }
-
-    const twentyPersonToMailchimpRecord: mailchimpRecord = prepareData(
-      twentyRecord.name.firstName,
-      twentyRecord.name.lastName,
-      twentyRecord.emails.primaryEmail,
-      twentyRecord.phones.primaryPhoneNumber,
-      twentyRecord.phones.primaryPhoneCallingCode,
-      companyName,
-      address,
-    );
-    console.log(twentyPersonToMailchimpRecord);
-
-    const isTwentyPersonInMailchimp: mailchimpRecord | undefined =
-      await checkIfTwentyPersonExistsInMailchimp(
-        twentyRecord.emails.primaryEmail,
-        twentyPersonToMailchimpRecord.sms_channel?.sms_phone,
-      );
-    if (isTwentyPersonInMailchimp !== undefined) {
-      console.log(
-        `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} found in Mailchimp`,
-      );
-      if (UPDATE_PERSON) {
-        if (
-          !compareTwoRecords(
-            isTwentyPersonInMailchimp,
-            twentyPersonToMailchimpRecord,
-          ) &&
-          isTwentyPersonInMailchimp.id
-        ) {
-          const isTwentyPersonUpdatedInMailchimp: boolean | undefined =
-            await updateTwentyPersonInMailchimp(
-              isTwentyPersonInMailchimp.id,
-              twentyPersonToMailchimpRecord,
-            );
-          if (!isTwentyPersonUpdatedInMailchimp) {
-            throw new Error(
-              `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} update in Mailchimp failed`,
-            );
-          } else {
-            console.log(
-              `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} update in Mailchimp succeeded`,
-            );
-          }
-        } else {
-          console.log(
-            `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} wasn't updated in Mailchimp because they're the same`,
-          );
-        }
-      } else {
-        console.log(
-          `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} wasn't updated in Mailchimp because UPDATE_PERSON is set to false`,
-        );
-      }
-    } else {
-      console.log(
-        `${twentyRecord.name.firstName} ${twentyRecord.name.lastName} doesn't exist in Mailchimp, adding`,
-      );
-      const isTwentyPersonAddedToMailchimp: boolean | undefined =
-        await addTwentyPersonToMailchimp(twentyPersonToMailchimpRecord);
-      if (!isTwentyPersonAddedToMailchimp) {
-        throw new Error(
-          `Adding ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} person to Mailchimp failed`,
-        );
-      } else {
-        console.log(
-          `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} has been successfully added`,
-        );
-      }
-    }
-    return {};
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      console.error(error.response);
-      return {};
-    }
-    console.error(error);
-    return {};
-  }
-};
-
-export const config: ServerlessFunctionConfig = {
-  universalIdentifier: '83319670-775b-4862-b133-5c353e594151',
-  name: 'mailchimp-synchronizer',
-  triggers: [
-    {
-      universalIdentifier: 'e627ff6f-0a0c-48b2-bdbb-31967489ec96',
-      type: 'databaseEvent',
-      eventName: 'person.created',
-    },
-    {
-      universalIdentifier: '657ece26-4478-4408-a257-4e9e16cce279',
-      type: 'databaseEvent',
-      eventName: 'person.updated',
-    },
-  ],
-};

packages/twenty-apps/community/mailchimp-synchronizer/src/index.ts

@@ -0,0 +1,447 @@
+import axios from 'axios';
+import {
+  type DatabaseEventPayload,
+  type FunctionConfig,
+  type ObjectRecordCreateEvent,
+  type ObjectRecordUpdateEvent,
+} from 'twenty-sdk';
+import Twenty, { type Person } from '../generated';
+
+const MAILCHIMP_API_URL: string =
+  process.env.MAILCHIMP_SERVER_PREFIX !== '' &&
+  process.env.MAILCHIMP_SERVER_PREFIX !== undefined
+    ? `https://${process.env.MAILCHIMP_SERVER_PREFIX}.api.mailchimp.com/3.0/`
+    : '';
+const MAILCHIMP_API_KEY: string = process.env.MAILCHIMP_API_KEY ?? '';
+const MAILCHIMP_AUDIENCE_ID: string = process.env.MAILCHIMP_AUDIENCE_ID ?? '';
+const IS_EMAIL_CONSTRAINT: boolean = process.env.IS_EMAIL_CONSTRAINT === 'true';
+const IS_COMPANY_CONSTRAINT: boolean =
+  process.env.COMPANY_CONSTRAINT === 'true';
+const IS_PHONE_CONSTRAINT: boolean = process.env.IS_PHONE_CONSTRAINT === 'true';
+const IS_ADDRESS_CONSTRAINT: boolean =
+  process.env.IS_ADDRESS_CONSTRAINT === 'true';
+const UPDATE_PERSON: boolean = process.env.UPDATE_PERSON === 'true';
+
+type mailchimpAddress = {
+  street1: string;
+  street2: string;
+  city: string;
+  state: string;
+  zipCode: string;
+  country: string;
+};
+
+type mailchimpRecord = {
+  id?: string;
+  email_channel?: {
+    email: string;
+    marketing_consent?: {
+      status: string;
+    };
+  };
+  sms_channel?: {
+    sms_phone: string;
+    marketing_consent?: {
+      status: string;
+    };
+  };
+  mergeFields: {
+    FNAME: string;
+    LNAME: string;
+    ADDRESS: string | mailchimpAddress;
+    COMPANY: string;
+    PHONE: string;
+  };
+};
+
+type twentyAddress = {
+  addressStreet1: string;
+  addressStreet2: string;
+  addressCity: string;
+  addressState: string;
+  addressPostCode: string;
+  addressCountry: string;
+};
+
+type twentyCompany = {
+  name: string;
+  address: twentyAddress;
+};
+
+type twentyPerson = {
+  name: {
+    firstName: string;
+    lastName: string;
+  };
+  emails: {
+    primaryEmail: string;
+  };
+  phones: {
+    primaryPhoneNumber: string;
+    primaryPhoneCallingCode: string;
+  };
+  companyId: string | null;
+};
+
+type DatabaseEvent =
+  | DatabaseEventPayload<ObjectRecordCreateEvent<Person>>
+  | DatabaseEventPayload<ObjectRecordUpdateEvent<Person>>;
+
+const fetchCompanyData = async (companyId: string): Promise<twentyCompany> => {
+  const { company } = await new Twenty().query({
+    company: {
+      __args: { filter: { id: { eq: companyId } } },
+      name: true,
+      address: {
+        addressStreet1: true,
+        addressStreet2: true,
+        addressState: true,
+        addressPostcode: true,
+        addressCity: true,
+        addressCountry: true,
+      },
+    },
+  });
+  return company as unknown as twentyCompany;
+};
+
+const checkAddress = (address: twentyAddress): mailchimpAddress => {
+  if (
+    address.addressStreet1 !== '' &&
+    address.addressCity !== '' &&
+    address.addressPostCode !== '' &&
+    address.addressState !== ''
+  ) {
+    return {
+      street1: address.addressStreet1,
+      street2: address.addressStreet2,
+      city: address.addressCity,
+      state: address.addressState,
+      zipCode: address.addressPostCode,
+      country: address.addressCountry,
+    } as mailchimpAddress;
+  }
+  throw new Error('Invalid address');
+};
+
+const checkAudiencePermissions = async (
+  audienceId: string,
+): Promise<string[] | undefined> => {
+  const options = {
+    method: 'GET',
+    headers: {
+      Authorization: `Bearer ${MAILCHIMP_API_KEY}`,
+    },
+    url: `${MAILCHIMP_API_URL}/audiences/${audienceId}`,
+  };
+  try {
+    const temp = await axios.request(options);
+    return temp.data.enabled_channels;
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const prepareData = (
+  firstName: string,
+  lastName: string,
+  email: string,
+  phoneNumber: string,
+  phoneCallingCode: string,
+  companyName: string,
+  address: mailchimpAddress | string,
+): mailchimpRecord => {
+  let data = {
+    mergeFields: {},
+  } as mailchimpRecord;
+  data.mergeFields.FNAME = firstName;
+  data.mergeFields.LNAME = lastName;
+  if (IS_EMAIL_CONSTRAINT) {
+    data.email_channel = {
+      email: email,
+      marketing_consent: {
+        status: 'unknown',
+      },
+    };
+  }
+  if (IS_ADDRESS_CONSTRAINT) {
+    data.mergeFields.ADDRESS = address;
+  }
+  if (IS_PHONE_CONSTRAINT) {
+    const mergedPhoneNumber: string = phoneCallingCode.startsWith('+')
+      ? phoneCallingCode.concat(phoneNumber)
+      : '+'.concat(phoneCallingCode, phoneNumber);
+    data['sms_channel'] = {
+      sms_phone: mergedPhoneNumber,
+      marketing_consent: {
+        status: 'unknown',
+      },
+    };
+    data['mergeFields']['PHONE'] = mergedPhoneNumber;
+  }
+  if (IS_COMPANY_CONSTRAINT) {
+    data['mergeFields']['COMPANY'] = companyName;
+  }
+  return data;
+};
+
+const addTwentyPersonToMailchimp = async (
+  convertedRecord: mailchimpRecord,
+): Promise<boolean | undefined> => {
+  const options = {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${MAILCHIMP_API_KEY}`,
+    },
+    url: `${MAILCHIMP_API_URL}/audiences/${MAILCHIMP_AUDIENCE_ID}/contacts`,
+    data: convertedRecord,
+  };
+  try {
+    const response = await axios.request(options);
+    return response.status === 200;
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const checkIfTwentyPersonExistsInMailchimp = async (
+  email?: string,
+  phoneNumber?: string,
+  cursor?: string,
+) => {
+  const options = {
+    method: 'GET',
+    headers: {
+      Authorization: `Bearer ${MAILCHIMP_API_KEY}`,
+    },
+    url: cursor
+      ? `${MAILCHIMP_API_URL}/audiences/${MAILCHIMP_AUDIENCE_ID}/contacts?count%3D1000%26cursor%3D${cursor}`
+      : `${MAILCHIMP_API_URL}/audiences/${MAILCHIMP_AUDIENCE_ID}/contacts?count%3D1000`,
+  };
+  try {
+    const response = await axios.request(options);
+    const doesPersonExist: mailchimpRecord | undefined =
+      (response.data.contacts.find(
+        (contact: any) => contact.email_channel.email === email,
+      ) as mailchimpRecord) ||
+      (response.data.contacts.find(
+        (contact: any) => contact.sms_channel.sms_phone === phoneNumber,
+      ) as mailchimpRecord);
+    if (doesPersonExist !== undefined) {
+      return doesPersonExist;
+    }
+    if (response.data.next_cursor === undefined) {
+      return undefined;
+    } else {
+      await checkIfTwentyPersonExistsInMailchimp(
+        email,
+        phoneNumber,
+        response.data.next_cursor,
+      );
+    }
+    return undefined;
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const compareTwoRecords = (
+  object1: mailchimpRecord,
+  object2: mailchimpRecord,
+) => {
+  return (
+    object1.email_channel?.email === object2.email_channel?.email &&
+    object1.sms_channel?.sms_phone === object2.sms_channel?.sms_phone &&
+    object1.mergeFields.FNAME === object2.mergeFields.FNAME &&
+    object1.mergeFields.LNAME === object2.mergeFields.LNAME &&
+    object1.mergeFields.ADDRESS === object2.mergeFields.ADDRESS &&
+    object1.mergeFields.COMPANY === object2.mergeFields.COMPANY
+  );
+};
+
+const updateTwentyPersonInMailchimp = async (
+  mailchimpRecordId: string,
+  twentyConvertedRecord: mailchimpRecord,
+): Promise<boolean | undefined> => {
+  const options = {
+    method: 'PATCH',
+    headers: {
+      Authorization: `Bearer ${MAILCHIMP_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    url: `${MAILCHIMP_API_URL}/audiences/${MAILCHIMP_AUDIENCE_ID}/contacts/${mailchimpRecordId}`,
+    data: twentyConvertedRecord,
+  };
+  try {
+    const response = await axios.request(options);
+    return response.status === 200;
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+export const main = async (
+  params: DatabaseEvent,
+): Promise<object | undefined> => {
+  if (!IS_EMAIL_CONSTRAINT && !IS_PHONE_CONSTRAINT) {
+    console.warn(
+      'Function exited as there are no constraints to email nor phone number',
+    );
+    return {};
+  }
+  if (
+    MAILCHIMP_API_URL === '' ||
+    MAILCHIMP_API_KEY === '' ||
+    MAILCHIMP_AUDIENCE_ID === ''
+  ) {
+    console.warn('Missing Mailchimp required parameters');
+    return {};
+  }
+
+  try {
+    const { properties } = params;
+    const twentyRecord: twentyPerson = properties.after as twentyPerson;
+    if (
+      twentyRecord.name.firstName === '' ||
+      twentyRecord.name.lastName === ''
+    ) {
+      throw new Error('First or last name is empty');
+    }
+
+    const audiencePermissions: string[] | undefined =
+      await checkAudiencePermissions(MAILCHIMP_AUDIENCE_ID);
+
+    if (
+      IS_EMAIL_CONSTRAINT &&
+      audiencePermissions?.includes('Email') &&
+      twentyRecord.emails.primaryEmail === ''
+    ) {
+      throw new Error('Email is empty');
+    }
+
+    if (
+      IS_PHONE_CONSTRAINT &&
+      audiencePermissions?.includes('SMS') &&
+      (twentyRecord.phones.primaryPhoneNumber === '' ||
+        twentyRecord.phones.primaryPhoneCallingCode === '')
+    ) {
+      throw new Error('Phone number is empty');
+    }
+
+    let companyName: string = '';
+    let address: mailchimpAddress | string = '';
+    if (IS_COMPANY_CONSTRAINT) {
+      if (twentyRecord.companyId === null) {
+        throw new Error('Missing relation to company record');
+      }
+      const company: twentyCompany = await fetchCompanyData(
+        twentyRecord.companyId,
+      );
+      companyName = company.name ?? ''; // either "" or name
+      address = IS_ADDRESS_CONSTRAINT ? checkAddress(company.address) : '';
+    }
+
+    const twentyPersonToMailchimpRecord: mailchimpRecord = prepareData(
+      twentyRecord.name.firstName,
+      twentyRecord.name.lastName,
+      twentyRecord.emails.primaryEmail,
+      twentyRecord.phones.primaryPhoneNumber,
+      twentyRecord.phones.primaryPhoneCallingCode,
+      companyName,
+      address,
+    );
+    console.log(twentyPersonToMailchimpRecord);
+
+    const isTwentyPersonInMailchimp: mailchimpRecord | undefined =
+      await checkIfTwentyPersonExistsInMailchimp(
+        twentyRecord.emails.primaryEmail,
+        twentyPersonToMailchimpRecord.sms_channel?.sms_phone,
+      );
+    if (isTwentyPersonInMailchimp !== undefined) {
+      console.log(
+        `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} found in Mailchimp`,
+      );
+      if (UPDATE_PERSON) {
+        if (
+          !compareTwoRecords(
+            isTwentyPersonInMailchimp,
+            twentyPersonToMailchimpRecord,
+          ) &&
+          isTwentyPersonInMailchimp.id
+        ) {
+          const isTwentyPersonUpdatedInMailchimp: boolean | undefined =
+            await updateTwentyPersonInMailchimp(
+              isTwentyPersonInMailchimp.id,
+              twentyPersonToMailchimpRecord,
+            );
+          if (!isTwentyPersonUpdatedInMailchimp) {
+            throw new Error(
+              `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} update in Mailchimp failed`,
+            );
+          } else {
+            console.log(
+              `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} update in Mailchimp succeeded`,
+            );
+          }
+        } else {
+          console.log(
+            `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} wasn't updated in Mailchimp because they're the same`,
+          );
+        }
+      } else {
+        console.log(
+          `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} wasn't updated in Mailchimp because UPDATE_PERSON is set to false`,
+        );
+      }
+    } else {
+      console.log(
+        `${twentyRecord.name.firstName} ${twentyRecord.name.lastName} doesn't exist in Mailchimp, adding`,
+      );
+      const isTwentyPersonAddedToMailchimp: boolean | undefined =
+        await addTwentyPersonToMailchimp(twentyPersonToMailchimpRecord);
+      if (!isTwentyPersonAddedToMailchimp) {
+        throw new Error(
+          `Adding ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} person to Mailchimp failed`,
+        );
+      } else {
+        console.log(
+          `Person ${twentyRecord.name.firstName} ${twentyRecord.name.lastName} has been successfully added`,
+        );
+      }
+    }
+    return {};
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      console.error(error.response);
+      return {};
+    }
+    console.error(error);
+    return {};
+  }
+};
+
+export const config: FunctionConfig = {
+  universalIdentifier: '83319670-775b-4862-b133-5c353e594151',
+  name: 'mailchimp-synchronizer',
+  triggers: [
+    {
+      universalIdentifier: 'e627ff6f-0a0c-48b2-bdbb-31967489ec96',
+      type: 'databaseEvent',
+      eventName: 'person.created',
+    },
+    {
+      universalIdentifier: '657ece26-4478-4408-a257-4e9e16cce279',
+      type: 'databaseEvent',
+      eventName: 'person.updated',
+    },
+  ],
+};

packages/twenty-apps/community/stripe-synchronizer/README.md

@@ -3,16 +3,15 @@
 Synchronizes customers from Stripe to Twenty
 
 ## Requirements
-- twenty-cli `npm install -g twenty-cli`
-- an `apiKey`. Go to `https://twenty.com/settings/api-webhooks` to generate one
+- an `apiKey` - go to Settings > API & Webhooks to generate one
 - Stripe secret API key - available in Stripe workbench
 
 ## Setup
 1. Synchronize app
 ```bash
-twenty auth login
-cd stripe-synchronizer
-twenty app sync
+cd packages/twenty-apps/community/stripe-synchronizer
+yarn auth
+yarn sync
 ```
 2. Go to Stripe > Workbench > Webhooks and add webhook:
 - events: customer.subscription.created and customer.subscription.updated
@@ -34,4 +33,5 @@ twenty app sync
 
 ## Todo
 - add validation of signature key from Stripe to ensure that incoming request is valid
-  (possible once request headers are exposed to serverless functions)
+  (possible once request headers are exposed to serverless functions)
+- update app so it'll use provided Twenty generated object with native types from workspace once extending objects is possible

packages/twenty-apps/community/stripe-synchronizer/application.config.ts

@@ -1,4 +1,4 @@
-import { type ApplicationConfig } from 'twenty-sdk/application';
+import { type ApplicationConfig } from 'twenty-sdk';
 
 const config: ApplicationConfig = {
   universalIdentifier: '0ed2bcb8-64ab-4ca1-b875-eeabf41b5f95',

packages/twenty-apps/community/stripe-synchronizer/package.json

@@ -10,9 +10,19 @@
   "packageManager": "yarn@4.9.2",
   "dependencies": {
     "axios": "^1.13.2",
-    "twenty-sdk": "0.0.4"
+    "twenty-sdk": "0.2.4"
   },
   "devDependencies": {
     "@types/node": "^24.7.2"
+  },
+  "scripts": {
+    "auth": "twenty auth login",
+    "generate": "twenty app generate",
+    "dev": "twenty app dev",
+    "sync": "twenty app sync",
+    "uninstall": "twenty app uninstall",
+    "logs": "twenty app logs",
+    "create-entity": "twenty app add",
+    "help": "twenty --help"
   }
 }

packages/twenty-apps/community/stripe-synchronizer/serverlessFunctions/stripe/src/index.ts

@@ -1,500 +0,0 @@
-import axios from 'axios';
-import { type ServerlessFunctionConfig } from 'twenty-sdk/application';
-import { type stripeCustomer, type stripeEvent, type stripeStatus, type twentyObject } from './types';
-
-const TWENTY_API_KEY: string = process.env.TWENTY_API_KEY ?? '';
-const TWENTY_API_URL: string =
-  process.env.TWENTY_API_URL !== '' && process.env.TWENTY_API_URL !== undefined
-    ? `${process.env.TWENTY_API_URL}/rest`
-    : 'https://api.twenty.com/rest';
-const STRIPE_API_KEY: string = process.env.STRIPE_API_KEY ?? '';
-const STRIPE_API_URL: string = 'https://api.stripe.com/v1/customers';
-
-const getTwentyObjectData = async (
-  objectSingularName: string,
-): Promise<twentyObject | undefined> => {
-  const options = {
-    method: 'GET',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    url: `${TWENTY_API_URL}/metadata/objects`,
-  };
-  try {
-    const response = await axios.request(options);
-    if (response.status === 200) {
-      const companyObject = response.data.data.objects.find(
-        (object: twentyObject) => object.nameSingular === objectSingularName,
-      );
-      return (companyObject as twentyObject) ?? ({} as twentyObject);
-    }
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const createFields = async (objectId: string, fieldName: string) => {
-  const data =
-    fieldName === 'seats'
-      ? {
-          type: 'NUMBER',
-          objectMetadataId: objectId,
-          name: 'seats',
-          label: 'Seats',
-          icon: 'IconMan',
-        }
-      : {
-          type: 'SELECT',
-          objectMetadataId: objectId,
-          name: 'subStatus',
-          label: 'Sub Status',
-          icon: 'IconStatusChange',
-          options: [
-            {
-              color: 'iris',
-              label: 'Incomplete',
-              value: 'INCOMPLETE',
-              position: 1,
-            },
-            {
-              color: 'sky',
-              label: 'Incomplete (expired)',
-              value: 'INCOMPLETE_EXPIRED',
-              position: 2,
-            },
-            {
-              color: 'amber',
-              label: 'Trialing',
-              value: 'TRIALING',
-              position: 3,
-            },
-            {
-              color: 'green',
-              label: 'Active',
-              value: 'ACTIVE',
-              position: 4,
-            },
-            {
-              color: 'orange',
-              label: 'Past due',
-              value: 'PAST_DUE',
-              position: 5,
-            },
-            {
-              color: 'brown',
-              label: 'Canceled',
-              value: 'CANCELED',
-              position: 6,
-            },
-            {
-              color: 'red',
-              label: 'Unpaid',
-              value: 'UNPAID',
-              position: 7,
-            },
-            {
-              color: 'gray',
-              label: 'Paused',
-              value: 'PAUSED',
-              position: 8,
-            },
-          ],
-        };
-
-  const options = {
-    method: 'POST',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-      'Content-Type': 'application/json',
-    },
-    url: `${TWENTY_API_URL}/metadata/fields`,
-    data: data,
-  };
-  try {
-    const response = await axios(options);
-    return response.status === 201;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const getStripeCustomerData = async (
-  customerID: string,
-): Promise<stripeCustomer | undefined> => {
-  const options = {
-    method: 'GET',
-    url: `${STRIPE_API_URL}/${customerID}`,
-    auth: {
-      username: STRIPE_API_KEY,
-      password: '',
-    },
-  };
-  try {
-    const response = await axios(options);
-    return response.status === 200
-      ? ({
-          name: response.data.name,
-          businessName: response.data.business_name,
-          email: response.data.email,
-        } as stripeCustomer)
-      : ({} as stripeCustomer);
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const checkIfCompanyExistsInTwenty = async (
-  name: string | undefined,
-): Promise<string | undefined> => {
-  const options = {
-    method: 'GET',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    url: `${TWENTY_API_URL}/companies?filter=name%5Beq%5D%3A%22${name}%22`,
-  };
-  try {
-    const response = await axios(options);
-    return response.status === 200 &&
-      response.data.data.companies[0].id !== undefined
-      ? (response.data.data.companies[0].id as string)
-      : '';
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const updateTwentyCompany = async (
-  companyId: string | undefined,
-  seats: number | null,
-  subStatus: stripeStatus,
-): Promise<boolean | undefined> => {
-  const options = {
-    method: 'PATCH',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-      'Content-Type': 'application/json',
-    },
-    url: `${TWENTY_API_URL}/companies/${companyId}`,
-    data: {
-      seats: seats,
-      subStatus: subStatus,
-    },
-  };
-  try {
-    const response = await axios(options);
-    return response.status === 200;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const createTwentyCompany = async (
-  customerName: string | undefined,
-  seats: number | null,
-  subStatus: string,
-): Promise<string | undefined> => {
-  const options = {
-    method: 'POST',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-      'Content-Type': 'application/json',
-    },
-    url: `${TWENTY_API_URL}/companies`,
-    data: {
-      name: customerName,
-      seats: seats,
-      subStatus: subStatus,
-    },
-  };
-  try {
-    const response = await axios(options);
-    return response.status === 201 ? (response.data.data.id as string) : '';
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const checkIfStripePersonExistsInTwenty = async (email: string | null) => {
-  const options = {
-    method: 'GET',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-      'Content-Type': 'application/json',
-    },
-    url: `${TWENTY_API_URL}/people?filter=emails.primaryEmail%5Beq%5D%3A%22${email}%22`, // mail is unique by default so there can be only 1 person with given mail
-  };
-  try {
-    const response = await axios.request(options);
-    return response.status === 200 &&
-      response.data.data.people[0].id !== undefined
-      ? (response.data.data.people[0].id as string)
-      : '';
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const addTwentyPerson = async (
-  firstName: string,
-  lastName: string,
-  email: string,
-  companyId: string,
-  seats: number,
-  subStatus: stripeStatus,
-): Promise<boolean | undefined> => {
-  const options = {
-    method: 'POST',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-      'Content-Type': 'application/json',
-    },
-    url: `${TWENTY_API_URL}/people`,
-    data: {
-      firstName: firstName,
-      lastName: lastName,
-      emails: { primaryEmail: email },
-      companyId: companyId,
-      seats: seats,
-      subStatus: subStatus,
-    },
-  };
-  try {
-    const response = await axios.request(options);
-    return response.status === 201;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const updateTwentyPerson = async (
-  id: string,
-  seats: number,
-  subStatus: stripeStatus,
-): Promise<boolean | undefined> => {
-  const options = {
-    method: 'PATCH',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-      'Content-Type': 'application/json',
-    },
-    url: `${TWENTY_API_URL}/people/${id}`,
-    data: {
-      seats: seats,
-      subStatus: subStatus,
-    },
-  };
-  try {
-    const response = await axios.request(options);
-    return response.status === 200;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-export const main = async (
-  params: Record<string, any>,
-): Promise<object | undefined> => {
-  if (TWENTY_API_KEY === '' || STRIPE_API_KEY === '') {
-    throw new Error('Missing variables');
-  }
-
-  try {
-    // TODO: add validation of signature key from Stripe (not possible at the moment as headers aren't accessible in serverless functions)
-    const stripe = params as stripeEvent;
-    const allowed_types: string[] = [
-      'customer.subscription.created',
-      'customer.subscription.updated',
-    ];
-    if (!allowed_types.includes(stripe.type)) {
-      throw new Error('Wrong type of webhook');
-    }
-
-    const stripeCustomer: stripeCustomer | undefined =
-      await getStripeCustomerData(stripe.data.object.customer);
-    if (
-      stripeCustomer?.businessName === undefined ||
-      stripeCustomer?.businessName === ''
-    ) {
-      console.warn('Set customer business name in Stripe');
-      return {};
-    }
-
-    const companyObject = await getTwentyObjectData('company');
-    if (
-      companyObject?.fields.find((field) => field.name === 'seats') ===
-      undefined
-    ) {
-      const seatsFieldCreated: boolean | undefined = companyObject?.id
-        ? await createFields(companyObject?.id, 'seats')
-        : false;
-      if (!seatsFieldCreated) {
-        throw new Error('Seats field creation in Company object failed');
-      } else {
-        console.info('Seats field creation in Company object succeeded');
-      }
-    }
-    if (
-      companyObject?.fields.find((field) => field.name === 'subStatus') ===
-      undefined
-    ) {
-      const subStatusFieldCreated: boolean | undefined = companyObject?.id
-        ? await createFields(companyObject?.id, 'subStatus')
-        : false;
-      if (!subStatusFieldCreated) {
-        throw new Error('Sub status field creation in Company object failed');
-      } else {
-        console.info('Sub status field creation in Company object succeeded');
-      }
-    }
-
-    const personObject = await getTwentyObjectData('person');
-    if (
-      personObject?.fields.find((field) => field.name === 'seats') === undefined
-    ) {
-      const seatsFieldCreated: boolean | undefined = personObject?.id
-        ? await createFields(personObject?.id, 'seats')
-        : false;
-      if (!seatsFieldCreated) {
-        throw new Error('Seats field creation in People object failed');
-      } else {
-        console.info('Seats field creation in People object succeeded');
-      }
-    }
-    if (
-      personObject?.fields.find((field) => field.name === 'subStatus') ===
-      undefined
-    ) {
-      const subStatusFieldCreated: boolean | undefined = personObject?.id
-        ? await createFields(personObject?.id, 'subStatus')
-        : false;
-      if (!subStatusFieldCreated) {
-        throw new Error('Sub status field creation in People object failed');
-      } else {
-        console.info('Sub status field creation in People object succeeded');
-      }
-    }
-
-    const twentyCompanyId: string | undefined =
-      await checkIfCompanyExistsInTwenty(stripeCustomer?.businessName);
-    const seats: number =
-      stripe.data.object.quantity ??
-      stripe.data.object.items.data.reduce(
-        (acc, item) => acc + item.quantity,
-        0,
-      ); // we don't know if subscription has only 1 item (product) or more
-    let updatedTwentyCompanyId: string | undefined;
-    if (twentyCompanyId === '') {
-      const twentyCompanyCreated: string | undefined =
-        await createTwentyCompany(
-          stripeCustomer?.businessName,
-          seats,
-          stripe.data.object.status.toUpperCase(),
-        );
-      if (twentyCompanyCreated === '') {
-        throw new Error('Creation of Stripe customer in Twenty failed');
-      } else {
-        console.log('Creation of Stripe customer in Twenty succeeded');
-        updatedTwentyCompanyId = twentyCompanyCreated;
-      }
-    } else {
-      const twentyCompanyUpdated: boolean | undefined =
-        await updateTwentyCompany(
-          twentyCompanyId,
-          seats,
-          stripe.data.object.status.toUpperCase() as stripeStatus,
-        );
-      if (!twentyCompanyUpdated) {
-        throw new Error('Update of Stripe customer in Twenty failed');
-      } else {
-        console.log('Update of Stripe customer in Twenty succeeded');
-        updatedTwentyCompanyId = twentyCompanyId;
-      }
-    }
-
-    if (updatedTwentyCompanyId === undefined || updatedTwentyCompanyId === '') {
-      throw new Error('TwentyCompanyId not found');
-    } else {
-      const stripeCustomerInTwenty: string | undefined =
-        await checkIfStripePersonExistsInTwenty(stripeCustomer.email);
-      if (stripeCustomerInTwenty === '') {
-        if (!stripeCustomer.name) {
-          throw new Error('Missing Stripe customer first or last name');
-        }
-        if (!stripeCustomer.email) {
-          throw new Error('Missing Stripe customer email');
-        }
-        const firstName: string = stripeCustomer.name?.split(' ')[0];
-        const lastName: string = stripeCustomer.name?.split(' ')[1];
-        const addedStripePersonToTwenty: boolean | undefined =
-          await addTwentyPerson(
-            firstName,
-            lastName,
-            stripeCustomer.email,
-            updatedTwentyCompanyId,
-            seats,
-            stripe.data.object.status.toUpperCase() as stripeStatus,
-          );
-        if (!addedStripePersonToTwenty) {
-          throw new Error('Adding Stripe person to Twenty failed');
-        } else {
-          console.log('Stripe person was added to Twenty');
-        }
-      } else if (stripeCustomerInTwenty !== undefined) {
-        const updatedStripePersonInTwenty: boolean | undefined =
-          await updateTwentyPerson(
-            stripeCustomerInTwenty,
-            seats,
-            stripe.data.object.status.toUpperCase() as stripeStatus,
-          );
-        if (!updatedStripePersonInTwenty) {
-          throw new Error('Update of Stripe person in Twenty failed');
-        } else {
-          console.log('Update of Stripe person in Twenty succeeded');
-        }
-      } else {
-        throw new Error('Twenty not found');
-      }
-    }
-    return {};
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      console.error(error.message);
-      return {};
-    }
-    console.error(error);
-    return {};
-  }
-};
-
-export const config: ServerlessFunctionConfig = {
-  universalIdentifier: 'cd15a738-18a5-406e-8b83-959dc52ebe14',
-  name: 'stripe',
-  triggers: [
-    {
-      universalIdentifier: '55f58e19-d832-43c4-9f8b-3f29fc05c162',
-      type: 'route',
-      path: '/webhook/stripe',
-      httpMethod: 'POST',
-      isAuthRequired: false,
-    },
-  ],
-};

packages/twenty-apps/community/stripe-synchronizer/src/index.ts

@@ -0,0 +1,505 @@
+import axios from 'axios';
+import { type FunctionConfig } from 'twenty-sdk';
+import {
+  type stripeCustomer,
+  type stripeEvent,
+  type stripeStatus,
+  type twentyObject,
+} from './types';
+
+const TWENTY_API_KEY: string = process.env.TWENTY_API_KEY ?? '';
+const TWENTY_API_URL: string =
+  process.env.TWENTY_API_URL !== '' && process.env.TWENTY_API_URL !== undefined
+    ? `${process.env.TWENTY_API_URL}/rest`
+    : 'https://api.twenty.com/rest';
+const STRIPE_API_KEY: string = process.env.STRIPE_API_KEY ?? '';
+const STRIPE_API_URL: string = 'https://api.stripe.com/v1/customers';
+
+const getTwentyObjectData = async (
+  objectSingularName: string,
+): Promise<twentyObject | undefined> => {
+  const options = {
+    method: 'GET',
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+    url: `${TWENTY_API_URL}/metadata/objects`,
+  };
+  try {
+    const response = await axios.request(options);
+    if (response.status === 200) {
+      const companyObject = response.data.data.objects.find(
+        (object: twentyObject) => object.nameSingular === objectSingularName,
+      );
+      return (companyObject as twentyObject) ?? ({} as twentyObject);
+    }
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const createFields = async (objectId: string, fieldName: string) => {
+  const data =
+    fieldName === 'seats'
+      ? {
+          type: 'NUMBER',
+          objectMetadataId: objectId,
+          name: 'seats',
+          label: 'Seats',
+          icon: 'IconMan',
+        }
+      : {
+          type: 'SELECT',
+          objectMetadataId: objectId,
+          name: 'subStatus',
+          label: 'Sub Status',
+          icon: 'IconStatusChange',
+          options: [
+            {
+              color: 'iris',
+              label: 'Incomplete',
+              value: 'INCOMPLETE',
+              position: 1,
+            },
+            {
+              color: 'sky',
+              label: 'Incomplete (expired)',
+              value: 'INCOMPLETE_EXPIRED',
+              position: 2,
+            },
+            {
+              color: 'amber',
+              label: 'Trialing',
+              value: 'TRIALING',
+              position: 3,
+            },
+            {
+              color: 'green',
+              label: 'Active',
+              value: 'ACTIVE',
+              position: 4,
+            },
+            {
+              color: 'orange',
+              label: 'Past due',
+              value: 'PAST_DUE',
+              position: 5,
+            },
+            {
+              color: 'brown',
+              label: 'Canceled',
+              value: 'CANCELED',
+              position: 6,
+            },
+            {
+              color: 'red',
+              label: 'Unpaid',
+              value: 'UNPAID',
+              position: 7,
+            },
+            {
+              color: 'gray',
+              label: 'Paused',
+              value: 'PAUSED',
+              position: 8,
+            },
+          ],
+        };
+
+  const options = {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    url: `${TWENTY_API_URL}/metadata/fields`,
+    data: data,
+  };
+  try {
+    const response = await axios(options);
+    return response.status === 201;
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const getStripeCustomerData = async (
+  customerID: string,
+): Promise<stripeCustomer | undefined> => {
+  const options = {
+    method: 'GET',
+    url: `${STRIPE_API_URL}/${customerID}`,
+    auth: {
+      username: STRIPE_API_KEY,
+      password: '',
+    },
+  };
+  try {
+    const response = await axios(options);
+    return response.status === 200
+      ? ({
+          name: response.data.name,
+          businessName: response.data.business_name,
+          email: response.data.email,
+        } as stripeCustomer)
+      : ({} as stripeCustomer);
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const checkIfCompanyExistsInTwenty = async (
+  name: string | undefined,
+): Promise<string | undefined> => {
+  const options = {
+    method: 'GET',
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+    url: `${TWENTY_API_URL}/companies?filter=name%5Beq%5D%3A%22${name}%22`,
+  };
+  try {
+    const response = await axios(options);
+    return response.status === 200 &&
+      response.data.data.companies[0].id !== undefined
+      ? (response.data.data.companies[0].id as string)
+      : '';
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const updateTwentyCompany = async (
+  companyId: string | undefined,
+  seats: number | null,
+  subStatus: stripeStatus,
+): Promise<boolean | undefined> => {
+  const options = {
+    method: 'PATCH',
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    url: `${TWENTY_API_URL}/companies/${companyId}`,
+    data: {
+      seats: seats,
+      subStatus: subStatus,
+    },
+  };
+  try {
+    const response = await axios(options);
+    return response.status === 200;
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const createTwentyCompany = async (
+  customerName: string | undefined,
+  seats: number | null,
+  subStatus: string,
+): Promise<string | undefined> => {
+  const options = {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    url: `${TWENTY_API_URL}/companies`,
+    data: {
+      name: customerName,
+      seats: seats,
+      subStatus: subStatus,
+    },
+  };
+  try {
+    const response = await axios(options);
+    return response.status === 201 ? (response.data.data.id as string) : '';
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const checkIfStripePersonExistsInTwenty = async (email: string | null) => {
+  const options = {
+    method: 'GET',
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    url: `${TWENTY_API_URL}/people?filter=emails.primaryEmail%5Beq%5D%3A%22${email}%22`, // mail is unique by default so there can be only 1 person with given mail
+  };
+  try {
+    const response = await axios.request(options);
+    return response.status === 200 &&
+      response.data.data.people[0].id !== undefined
+      ? (response.data.data.people[0].id as string)
+      : '';
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const addTwentyPerson = async (
+  firstName: string,
+  lastName: string,
+  email: string,
+  companyId: string,
+  seats: number,
+  subStatus: stripeStatus,
+): Promise<boolean | undefined> => {
+  const options = {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    url: `${TWENTY_API_URL}/people`,
+    data: {
+      firstName: firstName,
+      lastName: lastName,
+      emails: { primaryEmail: email },
+      companyId: companyId,
+      seats: seats,
+      subStatus: subStatus,
+    },
+  };
+  try {
+    const response = await axios.request(options);
+    return response.status === 201;
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+const updateTwentyPerson = async (
+  id: string,
+  seats: number,
+  subStatus: stripeStatus,
+): Promise<boolean | undefined> => {
+  const options = {
+    method: 'PATCH',
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    url: `${TWENTY_API_URL}/people/${id}`,
+    data: {
+      seats: seats,
+      subStatus: subStatus,
+    },
+  };
+  try {
+    const response = await axios.request(options);
+    return response.status === 200;
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+  }
+};
+
+export const main = async (
+  params: Record<string, any>,
+): Promise<object | undefined> => {
+  if (TWENTY_API_KEY === '' || STRIPE_API_KEY === '') {
+    throw new Error('Missing variables');
+  }
+
+  try {
+    // TODO: add validation of signature key from Stripe (not possible at the moment as headers aren't accessible in serverless functions)
+    const stripe = params as stripeEvent;
+    const allowed_types: string[] = [
+      'customer.subscription.created',
+      'customer.subscription.updated',
+    ];
+    if (!allowed_types.includes(stripe.type)) {
+      throw new Error('Wrong type of webhook');
+    }
+
+    const stripeCustomer: stripeCustomer | undefined =
+      await getStripeCustomerData(stripe.data.object.customer);
+    if (
+      stripeCustomer?.businessName === undefined ||
+      stripeCustomer?.businessName === ''
+    ) {
+      console.warn('Set customer business name in Stripe');
+      return {};
+    }
+
+    const companyObject = await getTwentyObjectData('company');
+    if (
+      companyObject?.fields.find((field) => field.name === 'seats') ===
+      undefined
+    ) {
+      const seatsFieldCreated: boolean | undefined = companyObject?.id
+        ? await createFields(companyObject?.id, 'seats')
+        : false;
+      if (!seatsFieldCreated) {
+        throw new Error('Seats field creation in Company object failed');
+      } else {
+        console.info('Seats field creation in Company object succeeded');
+      }
+    }
+    if (
+      companyObject?.fields.find((field) => field.name === 'subStatus') ===
+      undefined
+    ) {
+      const subStatusFieldCreated: boolean | undefined = companyObject?.id
+        ? await createFields(companyObject?.id, 'subStatus')
+        : false;
+      if (!subStatusFieldCreated) {
+        throw new Error('Sub status field creation in Company object failed');
+      } else {
+        console.info('Sub status field creation in Company object succeeded');
+      }
+    }
+
+    const personObject = await getTwentyObjectData('person');
+    if (
+      personObject?.fields.find((field) => field.name === 'seats') === undefined
+    ) {
+      const seatsFieldCreated: boolean | undefined = personObject?.id
+        ? await createFields(personObject?.id, 'seats')
+        : false;
+      if (!seatsFieldCreated) {
+        throw new Error('Seats field creation in People object failed');
+      } else {
+        console.info('Seats field creation in People object succeeded');
+      }
+    }
+    if (
+      personObject?.fields.find((field) => field.name === 'subStatus') ===
+      undefined
+    ) {
+      const subStatusFieldCreated: boolean | undefined = personObject?.id
+        ? await createFields(personObject?.id, 'subStatus')
+        : false;
+      if (!subStatusFieldCreated) {
+        throw new Error('Sub status field creation in People object failed');
+      } else {
+        console.info('Sub status field creation in People object succeeded');
+      }
+    }
+
+    const twentyCompanyId: string | undefined =
+      await checkIfCompanyExistsInTwenty(stripeCustomer?.businessName);
+    const seats: number =
+      stripe.data.object.quantity ??
+      stripe.data.object.items.data.reduce(
+        (acc, item) => acc + item.quantity,
+        0,
+      ); // we don't know if subscription has only 1 item (product) or more
+    let updatedTwentyCompanyId: string | undefined;
+    if (twentyCompanyId === '') {
+      const twentyCompanyCreated: string | undefined =
+        await createTwentyCompany(
+          stripeCustomer?.businessName,
+          seats,
+          stripe.data.object.status.toUpperCase(),
+        );
+      if (twentyCompanyCreated === '') {
+        throw new Error('Creation of Stripe customer in Twenty failed');
+      } else {
+        console.log('Creation of Stripe customer in Twenty succeeded');
+        updatedTwentyCompanyId = twentyCompanyCreated;
+      }
+    } else {
+      const twentyCompanyUpdated: boolean | undefined =
+        await updateTwentyCompany(
+          twentyCompanyId,
+          seats,
+          stripe.data.object.status.toUpperCase() as stripeStatus,
+        );
+      if (!twentyCompanyUpdated) {
+        throw new Error('Update of Stripe customer in Twenty failed');
+      } else {
+        console.log('Update of Stripe customer in Twenty succeeded');
+        updatedTwentyCompanyId = twentyCompanyId;
+      }
+    }
+
+    if (updatedTwentyCompanyId === undefined || updatedTwentyCompanyId === '') {
+      throw new Error('TwentyCompanyId not found');
+    } else {
+      const stripeCustomerInTwenty: string | undefined =
+        await checkIfStripePersonExistsInTwenty(stripeCustomer.email);
+      if (stripeCustomerInTwenty === '') {
+        if (!stripeCustomer.name) {
+          throw new Error('Missing Stripe customer first or last name');
+        }
+        if (!stripeCustomer.email) {
+          throw new Error('Missing Stripe customer email');
+        }
+        const firstName: string = stripeCustomer.name?.split(' ')[0];
+        const lastName: string = stripeCustomer.name?.split(' ')[1];
+        const addedStripePersonToTwenty: boolean | undefined =
+          await addTwentyPerson(
+            firstName,
+            lastName,
+            stripeCustomer.email,
+            updatedTwentyCompanyId,
+            seats,
+            stripe.data.object.status.toUpperCase() as stripeStatus,
+          );
+        if (!addedStripePersonToTwenty) {
+          throw new Error('Adding Stripe person to Twenty failed');
+        } else {
+          console.log('Stripe person was added to Twenty');
+        }
+      } else if (stripeCustomerInTwenty !== undefined) {
+        const updatedStripePersonInTwenty: boolean | undefined =
+          await updateTwentyPerson(
+            stripeCustomerInTwenty,
+            seats,
+            stripe.data.object.status.toUpperCase() as stripeStatus,
+          );
+        if (!updatedStripePersonInTwenty) {
+          throw new Error('Update of Stripe person in Twenty failed');
+        } else {
+          console.log('Update of Stripe person in Twenty succeeded');
+        }
+      } else {
+        throw new Error('Twenty not found');
+      }
+    }
+    return {};
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      console.error(error.message);
+      return {};
+    }
+    console.error(error);
+    return {};
+  }
+};
+
+export const config: FunctionConfig = {
+  universalIdentifier: 'cd15a738-18a5-406e-8b83-959dc52ebe14',
+  name: 'stripe',
+  triggers: [
+    {
+      universalIdentifier: '55f58e19-d832-43c4-9f8b-3f29fc05c162',
+      type: 'route',
+      path: '/webhook/stripe',
+      httpMethod: 'POST',
+      isAuthRequired: false,
+    },
+  ],
+};

packages/twenty-apps/community/updated-by/.yarnrc.yml

@@ -1,3 +0,0 @@
-yarnPath: .yarn/releases/yarn-4.9.2.cjs
-
-nodeLinker: node-modules

packages/twenty-apps/community/updated-by/README.md

@@ -1,36 +0,0 @@
-# Updated by
-
-Updates Updated by field with details of person behind newest update
-
-## Requirements
-- twenty-cli `npm install -g twenty-cli`
-- an `apiKey`. Go to `https://twenty.com/settings/api-webhooks` to generate one
-
-## Quick start
-
-1. Add application
-```bash
-twenty auth login
-cd packages/twenty-apps/updated-by
-twenty app sync
-```
-
-2. Configure **TWENTY_API_KEY**
-
-Go to Settings > Applications > Updated by > Settings and add Twenty API key used to
-send requests to Twenty. 
-
-**If you're using self-hosted instance, you have to add also URL to your workspace.**
-
-## Flow
-
-1. Check if Twenty API key is added, if not, exit
-2. Check if updated record belongs to an object which shouldn't have a `updatedBy` field (like blocklists or messages), if yes, exit
-3. Check if updated record has updatedBy field, if not, create it
-4. Check if updated field in record is updatedBy field, if yes, return preemptively
-5. Update record with workspace member ID
-
-## Notes
-
-- Updated by field shouldn't be changed by users, only by extension 
-- Amount of API requests is reduced to possible minimum

packages/twenty-apps/community/updated-by/application.config.ts

@@ -1,23 +0,0 @@
-import { type ApplicationConfig } from 'twenty-sdk/application';
-
-const config: ApplicationConfig = {
-  universalIdentifier: "113d22d6-6711-4c1f-807d-b69203d3a503",
-  displayName: "updated_by",
-  description: "Updates Updated by field with details of person behind newest update",
-  applicationVariables: {
-    TWENTY_API_KEY: {
-      universalIdentifier: "23df8d62-22b9-4d8e-9af9-b48c88a3c41b",
-      isSecret: true,
-      value: "",
-      description: "Required, used to send requests to Twenty"
-    },
-    TWENTY_API_URL: {
-      universalIdentifier: "aa8b9a8b-aded-48f2-bc30-fe9f0e6f4c60",
-      isSecret: false,
-      value: "",
-      description: "Optional, defaults to cloud API URL"
-    },
-  },
-}
-
-export default config;

packages/twenty-apps/community/updated-by/package.json

@@ -1,15 +0,0 @@
-{
-  "version": "0.0.1",
-  "license": "MIT",
-  "engines": {
-    "node": "^24.5.0",
-    "npm": "please-use-yarn",
-    "yarn": ">=4.0.2"
-  },
-  "packageManager": "yarn@4.9.2",
-  "$schema": "https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-cli/schemas/appManifest.schema.json",
-  "dependencies": {
-    "axios": "^1.13.1",
-    "twenty-sdk": "^0.0.4"
-  }
-}

packages/twenty-apps/community/updated-by/serverlessFunctions/updated/src/index.ts

@@ -1,237 +0,0 @@
-import axios from 'axios';
-import { type ServerlessFunctionConfig } from 'twenty-sdk/application';
-
-const TWENTY_API_KEY: string = process.env.TWENTY_API_KEY ?? '';
-const TWENTY_API_URL: string =
-  process.env.TWENTY_API_URL ?? 'https://api.twenty.com';
-const objectsNotForUpdate: string[] = [
-  'messageParticipants',
-  'blocklists',
-  'favoriteFolders',
-  'calendarEvents',
-  'attachments',
-  'workflowRuns',
-  'workflowAutomatedTriggers',
-  'messages',
-  'timelineActivities',
-  'workflows',
-  'calendarChannels',
-  'calendarChannelEventAssociations',
-  'viewFilters',
-  'viewFields',
-  'calendarEventParticipants',
-  'messageChannels',
-  'workspaceMembers',
-  'messageFolders',
-  'connectedAccounts',
-  'viewFilterGroups',
-  'noteTargets',
-  'views',
-  'workflowVersions',
-  'taskTargets',
-  'viewSorts',
-  'messageThreads',
-  'favorites',
-  'messageChannelMessageAssociations',
-  'viewGroups',
-];
-
-const returnWorkspaceMemberObjectId = async (): Promise<string> => {
-  const options = {
-    method: 'GET',
-    headers: {
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    url: `${TWENTY_API_URL}/rest/metadata/objects`,
-  };
-  const response = await axios.request(options);
-  return response.data.data.objects.find(
-    (object: any) => object.namePlural === 'workspaceMembers',
-  ).id;
-};
-
-const createUpdatedByFieldMetadata = async (
-  sourceObjectId: string,
-  workspaceMemberObjectId: string,
-  objectName: string,
-): Promise<boolean | undefined> => {
-  // taken directly from Network tab
-  const GraphQLQuery: string = `mutation CreateOneFieldMetadataItem($input: CreateOneFieldMetadataInput!) {
-  createOneField(input: $input) {
-    id
-    type
-    name
-    label
-    description
-    icon
-    isCustom
-    isActive
-    isUnique
-    isNullable
-    createdAt
-    updatedAt
-    settings
-    defaultValue
-    options
-    isLabelSyncedWithName
-    object {
-      id
-      __typename
-    }
-    __typename
-  }
-}`;
-
-  const variables = {
-    input: {
-      field: {
-        description: 'Shows the person behind newest update',
-        icon: 'IconRelationOneToMany',
-        label: 'Updated by',
-        name: 'updatedBy',
-        isLabelSyncedWithName: true,
-        objectMetadataId: `${sourceObjectId}`,
-        type: 'RELATION',
-        relationCreationPayload: {
-          type: 'MANY_TO_ONE',
-          targetObjectMetadataId: `${workspaceMemberObjectId}`,
-          targetFieldLabel: `Updated by ${objectName}`,
-          targetFieldIcon: 'IconUsers',
-        },
-      },
-    },
-  };
-
-  const options = {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    url: `${TWENTY_API_URL}/graphql`,
-    data: {
-      query: GraphQLQuery,
-      variables: variables,
-    },
-  };
-  try {
-    const response = await axios.request(options);
-    return response.status === 200;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-const updateUpdatedByFieldValue = async (
-  objectName: string,
-  workspaceMemberId: string,
-  recordId: string,
-): Promise<boolean | undefined> => {
-  const options = {
-    method: 'PATCH',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${TWENTY_API_KEY}`,
-    },
-    url: `${TWENTY_API_URL}/rest/${objectName}/${recordId}`,
-    data: {
-      updatedById: workspaceMemberId,
-    },
-  };
-  try {
-    const response = await axios.request(options);
-    return response.status === 200;
-  } catch (error) {
-    if (axios.isAxiosError(error)) {
-      throw error;
-    }
-  }
-};
-
-export const main = async (params: {
-  properties: Record<string, any>;
-  objectMetadata: Record<string, any>;
-  recordId: string;
-  workspaceMemberId: string;
-}): Promise<object> => {
-  if (TWENTY_API_KEY === '') {
-    console.error('You must specify a valid TWENTY_API_KEY');
-    return {};
-  }
-  try {
-    const { properties, objectMetadata, recordId, workspaceMemberId } = params;
-    if (objectsNotForUpdate.includes(objectMetadata.namePlural)) {
-      console.log('Updated object is immutable system object');
-      return {};
-    }
-
-    if (!workspaceMemberId) {
-      console.log('Exited as last update was done via API');
-      return {};
-    }
-
-    if (
-      properties.updatedFields?.length === 1 &&
-      properties.updatedFields.includes('updatedById')
-    ) {
-      console.log('Exited as last update was done by serverless function');
-      return {}; // if last update was updatedBy field, don't update
-    }
-
-    if (objectMetadata.fieldIdByJoinColumnName.updatedById === undefined) {
-      const workspaceMemberObjectId: string =
-        await returnWorkspaceMemberObjectId();
-
-      const isFieldCreated: boolean | undefined = await createUpdatedByFieldMetadata(
-        objectMetadata.id,
-        workspaceMemberObjectId,
-        objectMetadata.namePlural,
-      );
-      if (!isFieldCreated) {
-        console.error(`Creation of updated by field in ${objectMetadata.namePlural} failed`);
-        return {};
-      }
-      else {
-        console.log(`Updated by field in ${objectMetadata.namePlural} has been successfully created`);
-      }
-    }
-
-    const isObjectUpdated: boolean | undefined = await updateUpdatedByFieldValue(
-      objectMetadata.namePlural,
-      workspaceMemberId,
-      recordId,
-    );
-
-    if (isObjectUpdated) {
-      console.log(
-        `Field updatedBy in record ${recordId} in object ${objectMetadata.namePlural} has been updated`,
-      );
-      return {};
-    }
-    throw new Error(
-      `Update field updatedBy in record ${recordId} in object ${objectMetadata.namePlural} has failed!`,
-    );
-  } catch (error) {
-    console.error('Exiting because of error');
-    if (axios.isAxiosError(error)) {
-      console.error(error.message);
-    } else {
-      console.error(error);
-    }
-    return {};
-  }
-};
-
-export const config: ServerlessFunctionConfig = {
-  universalIdentifier: '47005bbc-ed0d-4d04-b53b-e94f5c38656d',
-  name: 'updated-by',
-  triggers: [
-    {
-      universalIdentifier: '0b6da7cf-506f-4cb9-b692-a44b08972ba4',
-      type: 'databaseEvent',
-      eventName: '*.updated',
-    },
-  ],
-};

packages/twenty-apps/community/updated-by/tsconfig.json

@@ -1,26 +0,0 @@
-{
-  "compileOnSave": false,
-  "compilerOptions": {
-    "sourceMap": true,
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": ".",
-    "moduleResolution": "node",
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "importHelpers": true,
-    "strict": true,
-    "target": "es2018",
-    "module": "esnext",
-    "lib": ["es2020", "dom"],
-    "skipLibCheck": true,
-    "skipDefaultLibCheck": true,
-    "resolveJsonModule": true
-  },
-  "exclude": [
-    "node_modules",
-    "dist",
-    "**/*.test.ts",
-    "**/*.spec.ts"
-  ]
-}

packages/twenty-apps/community/updated-by/yarn.lock

@@ -1,256 +0,0 @@
-# This file is generated by running "yarn install" inside your project.
-# Manual changes might be lost - proceed with caution!
-
-__metadata:
-  version: 8
-  cacheKey: 10c0
-
-"async-function@npm:^1.0.0":
-  version: 1.0.0
-  resolution: "async-function@npm:1.0.0"
-  checksum: 10c0/669a32c2cb7e45091330c680e92eaeb791bc1d4132d827591e499cd1f776ff5a873e77e5f92d0ce795a8d60f10761dec9ddfe7225a5de680f5d357f67b1aac73
-  languageName: node
-  linkType: hard
-
-"async-generator-function@npm:^1.0.0":
-  version: 1.0.0
-  resolution: "async-generator-function@npm:1.0.0"
-  checksum: 10c0/2c50ef856c543ad500d8d8777d347e3c1ba623b93e99c9263ecc5f965c1b12d2a140e2ab6e43c3d0b85366110696f28114649411cbcd10b452a92a2318394186
-  languageName: node
-  linkType: hard
-
-"asynckit@npm:^0.4.0":
-  version: 0.4.0
-  resolution: "asynckit@npm:0.4.0"
-  checksum: 10c0/d73e2ddf20c4eb9337e1b3df1a0f6159481050a5de457c55b14ea2e5cb6d90bb69e004c9af54737a5ee0917fcf2c9e25de67777bbe58261847846066ba75bc9d
-  languageName: node
-  linkType: hard
-
-"axios@npm:^1.13.1":
-  version: 1.13.1
-  resolution: "axios@npm:1.13.1"
-  dependencies:
-    follow-redirects: "npm:^1.15.6"
-    form-data: "npm:^4.0.4"
-    proxy-from-env: "npm:^1.1.0"
-  checksum: 10c0/de9c3c6de43d3ee1146d3afe78645f19450cac6a5d7235bef8b8e8eeb705c2e47e2d231dea99cecaec4dae1897c521118ca9413b9d474063c719c4d94c5b9adc
-  languageName: node
-  linkType: hard
-
-"call-bind-apply-helpers@npm:^1.0.1, call-bind-apply-helpers@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "call-bind-apply-helpers@npm:1.0.2"
-  dependencies:
-    es-errors: "npm:^1.3.0"
-    function-bind: "npm:^1.1.2"
-  checksum: 10c0/47bd9901d57b857590431243fea704ff18078b16890a6b3e021e12d279bbf211d039155e27d7566b374d49ee1f8189344bac9833dec7a20cdec370506361c938
-  languageName: node
-  linkType: hard
-
-"combined-stream@npm:^1.0.8":
-  version: 1.0.8
-  resolution: "combined-stream@npm:1.0.8"
-  dependencies:
-    delayed-stream: "npm:~1.0.0"
-  checksum: 10c0/0dbb829577e1b1e839fa82b40c07ffaf7de8a09b935cadd355a73652ae70a88b4320db322f6634a4ad93424292fa80973ac6480986247f1734a1137debf271d5
-  languageName: node
-  linkType: hard
-
-"delayed-stream@npm:~1.0.0":
-  version: 1.0.0
-  resolution: "delayed-stream@npm:1.0.0"
-  checksum: 10c0/d758899da03392e6712f042bec80aa293bbe9e9ff1b2634baae6a360113e708b91326594c8a486d475c69d6259afb7efacdc3537bfcda1c6c648e390ce601b19
-  languageName: node
-  linkType: hard
-
-"dunder-proto@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "dunder-proto@npm:1.0.1"
-  dependencies:
-    call-bind-apply-helpers: "npm:^1.0.1"
-    es-errors: "npm:^1.3.0"
-    gopd: "npm:^1.2.0"
-  checksum: 10c0/199f2a0c1c16593ca0a145dbf76a962f8033ce3129f01284d48c45ed4e14fea9bbacd7b3610b6cdc33486cef20385ac054948fefc6272fcce645c09468f93031
-  languageName: node
-  linkType: hard
-
-"es-define-property@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "es-define-property@npm:1.0.1"
-  checksum: 10c0/3f54eb49c16c18707949ff25a1456728c883e81259f045003499efba399c08bad00deebf65cccde8c0e07908c1a225c9d472b7107e558f2a48e28d530e34527c
-  languageName: node
-  linkType: hard
-
-"es-errors@npm:^1.3.0":
-  version: 1.3.0
-  resolution: "es-errors@npm:1.3.0"
-  checksum: 10c0/0a61325670072f98d8ae3b914edab3559b6caa980f08054a3b872052640d91da01d38df55df797fcc916389d77fc92b8d5906cf028f4db46d7e3003abecbca85
-  languageName: node
-  linkType: hard
-
-"es-object-atoms@npm:^1.0.0, es-object-atoms@npm:^1.1.1":
-  version: 1.1.1
-  resolution: "es-object-atoms@npm:1.1.1"
-  dependencies:
-    es-errors: "npm:^1.3.0"
-  checksum: 10c0/65364812ca4daf48eb76e2a3b7a89b3f6a2e62a1c420766ce9f692665a29d94fe41fe88b65f24106f449859549711e4b40d9fb8002d862dfd7eb1c512d10be0c
-  languageName: node
-  linkType: hard
-
-"es-set-tostringtag@npm:^2.1.0":
-  version: 2.1.0
-  resolution: "es-set-tostringtag@npm:2.1.0"
-  dependencies:
-    es-errors: "npm:^1.3.0"
-    get-intrinsic: "npm:^1.2.6"
-    has-tostringtag: "npm:^1.0.2"
-    hasown: "npm:^2.0.2"
-  checksum: 10c0/ef2ca9ce49afe3931cb32e35da4dcb6d86ab02592cfc2ce3e49ced199d9d0bb5085fc7e73e06312213765f5efa47cc1df553a6a5154584b21448e9fb8355b1af
-  languageName: node
-  linkType: hard
-
-"follow-redirects@npm:^1.15.6":
-  version: 1.15.11
-  resolution: "follow-redirects@npm:1.15.11"
-  peerDependenciesMeta:
-    debug:
-      optional: true
-  checksum: 10c0/d301f430542520a54058d4aeeb453233c564aaccac835d29d15e050beb33f339ad67d9bddbce01739c5dc46a6716dbe3d9d0d5134b1ca203effa11a7ef092343
-  languageName: node
-  linkType: hard
-
-"form-data@npm:^4.0.4":
-  version: 4.0.4
-  resolution: "form-data@npm:4.0.4"
-  dependencies:
-    asynckit: "npm:^0.4.0"
-    combined-stream: "npm:^1.0.8"
-    es-set-tostringtag: "npm:^2.1.0"
-    hasown: "npm:^2.0.2"
-    mime-types: "npm:^2.1.12"
-  checksum: 10c0/373525a9a034b9d57073e55eab79e501a714ffac02e7a9b01be1c820780652b16e4101819785e1e18f8d98f0aee866cc654d660a435c378e16a72f2e7cac9695
-  languageName: node
-  linkType: hard
-
-"function-bind@npm:^1.1.2":
-  version: 1.1.2
-  resolution: "function-bind@npm:1.1.2"
-  checksum: 10c0/d8680ee1e5fcd4c197e4ac33b2b4dce03c71f4d91717292785703db200f5c21f977c568d28061226f9b5900cbcd2c84463646134fd5337e7925e0942bc3f46d5
-  languageName: node
-  linkType: hard
-
-"generator-function@npm:^2.0.0":
-  version: 2.0.1
-  resolution: "generator-function@npm:2.0.1"
-  checksum: 10c0/8a9f59df0f01cfefafdb3b451b80555e5cf6d76487095db91ac461a0e682e4ff7a9dbce15f4ecec191e53586d59eece01949e05a4b4492879600bbbe8e28d6b8
-  languageName: node
-  linkType: hard
-
-"get-intrinsic@npm:^1.2.6":
-  version: 1.3.1
-  resolution: "get-intrinsic@npm:1.3.1"
-  dependencies:
-    async-function: "npm:^1.0.0"
-    async-generator-function: "npm:^1.0.0"
-    call-bind-apply-helpers: "npm:^1.0.2"
-    es-define-property: "npm:^1.0.1"
-    es-errors: "npm:^1.3.0"
-    es-object-atoms: "npm:^1.1.1"
-    function-bind: "npm:^1.1.2"
-    generator-function: "npm:^2.0.0"
-    get-proto: "npm:^1.0.1"
-    gopd: "npm:^1.2.0"
-    has-symbols: "npm:^1.1.0"
-    hasown: "npm:^2.0.2"
-    math-intrinsics: "npm:^1.1.0"
-  checksum: 10c0/9f4ab0cf7efe0fd2c8185f52e6f637e708f3a112610c88869f8f041bb9ecc2ce44bf285dfdbdc6f4f7c277a5b88d8e94a432374d97cca22f3de7fc63795deb5d
-  languageName: node
-  linkType: hard
-
-"get-proto@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "get-proto@npm:1.0.1"
-  dependencies:
-    dunder-proto: "npm:^1.0.1"
-    es-object-atoms: "npm:^1.0.0"
-  checksum: 10c0/9224acb44603c5526955e83510b9da41baf6ae73f7398875fba50edc5e944223a89c4a72b070fcd78beb5f7bdda58ecb6294adc28f7acfc0da05f76a2399643c
-  languageName: node
-  linkType: hard
-
-"gopd@npm:^1.2.0":
-  version: 1.2.0
-  resolution: "gopd@npm:1.2.0"
-  checksum: 10c0/50fff1e04ba2b7737c097358534eacadad1e68d24cccee3272e04e007bed008e68d2614f3987788428fd192a5ae3889d08fb2331417e4fc4a9ab366b2043cead
-  languageName: node
-  linkType: hard
-
-"has-symbols@npm:^1.0.3, has-symbols@npm:^1.1.0":
-  version: 1.1.0
-  resolution: "has-symbols@npm:1.1.0"
-  checksum: 10c0/dde0a734b17ae51e84b10986e651c664379018d10b91b6b0e9b293eddb32f0f069688c841fb40f19e9611546130153e0a2a48fd7f512891fb000ddfa36f5a20e
-  languageName: node
-  linkType: hard
-
-"has-tostringtag@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "has-tostringtag@npm:1.0.2"
-  dependencies:
-    has-symbols: "npm:^1.0.3"
-  checksum: 10c0/a8b166462192bafe3d9b6e420a1d581d93dd867adb61be223a17a8d6dad147aa77a8be32c961bb2f27b3ef893cae8d36f564ab651f5e9b7938ae86f74027c48c
-  languageName: node
-  linkType: hard
-
-"hasown@npm:^2.0.2":
-  version: 2.0.2
-  resolution: "hasown@npm:2.0.2"
-  dependencies:
-    function-bind: "npm:^1.1.2"
-  checksum: 10c0/3769d434703b8ac66b209a4cca0737519925bbdb61dd887f93a16372b14694c63ff4e797686d87c90f08168e81082248b9b028bad60d4da9e0d1148766f56eb9
-  languageName: node
-  linkType: hard
-
-"math-intrinsics@npm:^1.1.0":
-  version: 1.1.0
-  resolution: "math-intrinsics@npm:1.1.0"
-  checksum: 10c0/7579ff94e899e2f76ab64491d76cf606274c874d8f2af4a442c016bd85688927fcfca157ba6bf74b08e9439dc010b248ce05b96cc7c126a354c3bae7fcb48b7f
-  languageName: node
-  linkType: hard
-
-"mime-db@npm:1.52.0":
-  version: 1.52.0
-  resolution: "mime-db@npm:1.52.0"
-  checksum: 10c0/0557a01deebf45ac5f5777fe7740b2a5c309c6d62d40ceab4e23da9f821899ce7a900b7ac8157d4548ddbb7beffe9abc621250e6d182b0397ec7f10c7b91a5aa
-  languageName: node
-  linkType: hard
-
-"mime-types@npm:^2.1.12":
-  version: 2.1.35
-  resolution: "mime-types@npm:2.1.35"
-  dependencies:
-    mime-db: "npm:1.52.0"
-  checksum: 10c0/82fb07ec56d8ff1fc999a84f2f217aa46cb6ed1033fefaabd5785b9a974ed225c90dc72fff460259e66b95b73648596dbcc50d51ed69cdf464af2d237d3149b2
-  languageName: node
-  linkType: hard
-
-"proxy-from-env@npm:^1.1.0":
-  version: 1.1.0
-  resolution: "proxy-from-env@npm:1.1.0"
-  checksum: 10c0/fe7dd8b1bdbbbea18d1459107729c3e4a2243ca870d26d34c2c1bcd3e4425b7bcc5112362df2d93cc7fb9746f6142b5e272fd1cc5c86ddf8580175186f6ad42b
-  languageName: node
-  linkType: hard
-
-"root-workspace-0b6124@workspace:.":
-  version: 0.0.0-use.local
-  resolution: "root-workspace-0b6124@workspace:."
-  dependencies:
-    axios: "npm:^1.13.1"
-    twenty-sdk: "npm:^0.0.4"
-  languageName: unknown
-  linkType: soft
-
-"twenty-sdk@npm:^0.0.4":
-  version: 0.0.4
-  resolution: "twenty-sdk@npm:0.0.4"
-  checksum: 10c0/550f1d85bf0701396c9dd2d4c6bc55ba1b067fce13636f8540eec60ab6a4257c6d7cd86cb3f62e0974bf99467bc31270d92b17b9681a1b7a6281b7ef97224080
-  languageName: node
-  linkType: hard

packages/twenty-apps/hello-world/application.config.ts

@@ -1,22 +0,0 @@
-import { type ApplicationConfig } from 'twenty-sdk';
-
-const config: ApplicationConfig = {
-  universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
-  displayName: 'Hello World',
-  description: 'A simple hello world app',
-  icon: 'IconWorld',
-  applicationVariables: {
-    TWENTY_API_KEY: {
-      universalIdentifier: 'dedc53eb-9c12-4fe2-ba86-4a2add19d305',
-      description: 'Twenty API Key',
-      isSecret: true,
-    },
-    TWENTY_API_URL: {
-      universalIdentifier: 'ef8ab489-e68a-4841-b402-261f440e6185',
-      description: 'Twenty API Url',
-      isSecret: false,
-    },
-  },
-};
-
-export default config;

packages/twenty-apps/hello-world/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hello-world",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "license": "MIT",
   "engines": {
     "node": "^24.5.0",
@@ -17,7 +17,7 @@
     "auth": "twenty auth login"
   },
   "dependencies": {
-    "twenty-sdk": "0.1.2"
+    "twenty-sdk": "0.2.4"
   },
   "devDependencies": {
     "@types/node": "^24.7.2"

packages/twenty-apps/hello-world/src/actions/create-new-post-card.ts

@@ -1,21 +1,30 @@
-import { type FunctionConfig } from 'twenty-sdk';
-import { createClient } from '../../generated';
+import type {
+  FunctionConfig,
+  DatabaseEventPayload,
+  ObjectRecordCreateEvent,
+  CronPayload,
+} from 'twenty-sdk';
+import Twenty, { type Person } from '../../generated';
 
-export const main = async (params: { recipient?: string }) => {
+type CreateNewPostCardParams =
+  | { name?: string }
+  | DatabaseEventPayload<ObjectRecordCreateEvent<Person>>
+  | CronPayload;
+
+export const main = async (params: CreateNewPostCardParams) => {
   try {
-    const client = createClient({
-      url: `${process.env.TWENTY_API_URL}/graphql`,
-      headers: {
-        'Content-Type': 'application/json',
-        Authorization: `Bearer ${process.env.TWENTY_API_KEY}`,
-      },
-    });
+    const client = new Twenty();
+
+    const name =
+      'name' in params
+        ? params.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
+        : 'Hello world';
 
     const createPostCard = await client.mutation({
       createPostCard: {
         __args: {
           data: {
-            name: params.recipient ?? 'Hello-world',
+            name,
           },
         },
         name: true,

packages/twenty-apps/hello-world/src/application.config.ts

@@ -0,0 +1,19 @@
+import { type ApplicationConfig } from 'twenty-sdk';
+
+const config: ApplicationConfig = {
+  universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
+  displayName: 'Hello World',
+  description: 'A simple hello world app',
+  icon: 'IconWorld',
+  applicationVariables: {
+    DEFAULT_RECIPIENT_NAME: {
+      universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
+      description: 'Default recipient name for postcards',
+      value: 'Alex Karp',
+      isSecret: false,
+    },
+  },
+  functionRoleUniversalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+};
+
+export default config;

packages/twenty-apps/hello-world/src/roles/function-role.ts

@@ -0,0 +1,33 @@
+import { PermissionFlag, type RoleConfig } from 'twenty-sdk';
+
+export const functionRole: RoleConfig = {
+  universalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+  label: 'Default function role',
+  description: 'Default role for function Twenty client',
+  canReadAllObjectRecords: false,
+  canUpdateAllObjectRecords: false,
+  canSoftDeleteAllObjectRecords: false,
+  canDestroyAllObjectRecords: false,
+  canUpdateAllSettings: false,
+  canBeAssignedToAgents: false,
+  canBeAssignedToUsers: false,
+  canBeAssignedToApiKeys: false,
+  objectPermissions: [
+    {
+      objectNameSingular: 'postCard',
+      canReadObjectRecords: true,
+      canUpdateObjectRecords: true,
+      canSoftDeleteObjectRecords: false,
+      canDestroyObjectRecords: false,
+    },
+  ],
+  fieldPermissions: [
+    {
+      objectNameSingular: 'postCard',
+      fieldName: 'content',
+      canReadFieldValue: false,
+      canUpdateFieldValue: false,
+    },
+  ],
+  permissionFlags: [PermissionFlag.APPLICATIONS],
+};

packages/twenty-apps/hello-world/yarn.lock

@@ -1021,6 +1021,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"graphql-sse@npm:^2.5.4":
+  version: 2.6.0
+  resolution: "graphql-sse@npm:2.6.0"
+  peerDependencies:
+    graphql: ">=0.11 <=16"
+  checksum: 10c0/e05f0b5c8539d61e5ce34af8e0bb418c02bf922d6a7f9232a9abd53c77df5654684ca14f674ac771645c8fba9c37ce666c5d06f46eef54ea07e63653468065b0
+  languageName: node
+  linkType: hard
+
 "graphql@npm:^16.6.0, graphql@npm:^16.8.1":
   version: 16.12.0
   resolution: "graphql@npm:16.12.0"
@@ -1074,7 +1083,7 @@ __metadata:
   resolution: "hello-world@workspace:."
   dependencies:
     "@types/node": "npm:^24.7.2"
-    twenty-sdk: "npm:0.1.2"
+    twenty-sdk: "npm:0.2.4"
   languageName: unknown
   linkType: soft
 
@@ -1895,9 +1904,9 @@ __metadata:
   languageName: node
   linkType: hard
 
-"twenty-sdk@npm:0.1.2":
-  version: 0.1.2
-  resolution: "twenty-sdk@npm:0.1.2"
+"twenty-sdk@npm:0.2.4":
+  version: 0.2.4
+  resolution: "twenty-sdk@npm:0.2.4"
   dependencies:
     "@genql/cli": "npm:^3.0.3"
     axios: "npm:^1.6.0"
@@ -1907,6 +1916,7 @@ __metadata:
     dotenv: "npm:^16.4.0"
     fs-extra: "npm:^11.2.0"
     graphql: "npm:^16.8.1"
+    graphql-sse: "npm:^2.5.4"
     inquirer: "npm:^10.0.0"
     jsonc-parser: "npm:^3.2.0"
     lodash.camelcase: "npm:^4.3.0"
@@ -1917,7 +1927,7 @@ __metadata:
     uuid: "npm:^13.0.0"
   bin:
     twenty: dist/cli.cjs
-  checksum: 10c0/18cb8c589b6d6c6e59d58c28eae333718d62df485d827ba41e99421ef9fb359c3f71fa42d80b1e5463d2140b68de084aee81bf541e70c0d04a246c332e2978e7
+  checksum: 10c0/91bcc2c6a96d8bb7997c6584de338d370ffd4cebbc052ffdd5dd8bb8894f1851c039601a2ce0bb0f3b97e210f3bc877de0572125b8c3b601f6e1baac2f99a8c5
   languageName: node
   linkType: hard
 

packages/twenty-cli/README.md

@@ -1,89 +1,8 @@
 # Deprecated: twenty-cli
 
-This package is deprecated. Please install and use twenty-sdk instead:
+This package is deprecated. Please install and use [twenty-sdk](https://www.npmjs.com/package/twenty-sdk) instead:
 
 ```bash
 npm uninstall twenty-cli
 npm install -g twenty-sdk
 ```
-
-The command name remains the same: twenty.
-
-A command-line interface to easily scaffold, develop, and publish applications that extend Twenty CRM (now provided by twenty-sdk).
-
-## Requirements
-- yarn >= 4.9.2
-- an `apiKey`. Go to `https://twenty.com/settings/api-webhooks` to generate one
-
-## Quick example project
-
-```bash
-# Authenticate using your apiKey (CLI will prompt for your <apiKey>)
-twenty auth login
-
-# Init a new application called hello-world
-twenty app init hello-world
-
-# Go to your app
-cd hello-world
-
-# Add a serverless function to your application
-twenty app add serverlessFunction
-
-# Add a trigger to your serverless function
-twenty app add trigger
-
-# Add axios to your application
-yarn add axios
-
-# Start dev mode: automatically syncs changes to your Twenty workspace, so you can test new functions/objects instantly.
-twenty app dev
-
-# Or use one time sync (also generates SDK automatically)
-twenty app sync
-
-# List all available commands
-twenty help
-```
-
-## Application Structure
-
-Each application in this package follows the standard application structure:
-
-```
-app-name/
-├── package.json
-├── README.md
-├── serverlessFunctions  # Custom backend logic (runs on demand)
-└── ...
-```
-
-## Publish your application
-
-Applications are currently stored in twenty/packages/twenty-apps.
-
-You can share your application with all twenty users.
-
-```bash
-# pull 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.
-
-## Contributing
-
-- see our [Hacktoberfest 2025 notion page](https://twentycrm.notion.site/Hacktoberfest-27711d8417038037a149d4638a9cc510)
-- our [Discord](https://discord.gg/cx5n4Jzs57)

packages/twenty-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twenty-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "[DEPRECATED] Use twenty-sdk instead: https://www.npmjs.com/package/twenty-sdk",
   "scripts": {
     "build": "echo 'use npx nx build'",

packages/twenty-docs/developers/api-and-webhooks/api.mdx

@@ -1,49 +0,0 @@
----
-title: API
-image: /images/docs/getting-started/api.png
-info: Discover how to use our APIs.
----
-<Frame>
-  <img src="/images/docs/getting-started/api.png" alt="Header" />
-</Frame>
-
-## Overview
-The Twenty API allows developers to interact programmatically with the Twenty CRM platform. Using the API, you can integrate Twenty with other systems, automate data synchronization, and build custom solutions around your customer data. The API provides endpoints to **create, read, update, and delete** core CRM objects (such as people and companies) as well as access metadata configuration.
-
-**API Playground:**  You can now access the API Playground within the app's settings. To try out API calls in real-time, log in to your Twenty workspace and navigate to **Settings → APIs & Webhooks**. This opens the in-app API Playground and the settings for API keys.
-**[Go to API Settings](https://app.twenty.com/settings)**
-
-## Authentication
-Twenty’s API uses API keys for authentication. Every request to protected endpoints must include an API key in the header.
-
-* **API Keys:** You can generate a new API key from your Twenty app’s **API settings** page. Each API key is a secret token that grants access to your CRM data, so keep it safe. If a key is compromised, revoke it from the settings and generate a new one.
-* **Auth Header:** Once you have an API key, include it in the `Authorization` header of your HTTP requests. Use the Bearer token scheme. For example:
-  ```
-  Authorization: Bearer YOUR_API_KEY
-  ```
-
-  Replace `YOUR_API_KEY` with the key you obtained. This header must be present on **all API requests**. If the token is missing or invalid, the API will respond with an authentication error (HTTP 401 Unauthorized).
-
-## API Endpoints
-All resources can be accessed and via REST or GraphQL.
-
-* **Cloud:** `https://api.twenty.com/` or your custom domain / sub-domain
-* **Self-Hosted Instances:** If you are running Twenty on your own server, use your own domain in place of `api.twenty.com` (for example, `https://{your-domain}/rest/`).
-
-Endpoints are grouped into two categories: **Core API** and **Metadata API**. The **Core API** deals with primary CRM data (e.g. people, companies, notes, tasks), while the **Metadata API** covers configuration data (like custom fields or object definitions). Most integrations will primarily use the Core API.
-
-### Core API
-Accessed on `/rest/` or `/graphql/`.
-The **Core API** serves as a unified interface for managing core CRM entities (people, companies, notes, tasks) and their relationships, offering **both REST and GraphQL** interaction models.
-
-### Metadata API
-Accessed on `/rest/metadata/` or `/metadata/`.
-The Metadata API endpoints allow you to retrieve information about your schema and settings. For instance, you can fetch definitions of custom fields, object schemas, etc.
-
-* **Example Endpoints:**
-
-  * `GET /rest/metadata/objects` – List all object types and their metadata (fields, relationships).
-  * `GET /rest/metadata/objects/{objectName}` – Get metadata for a specific object (e.g., `people`, `companies`).
-  * `GET /rest/metadata/picklists` – Retrieve picklist (dropdown) field options defined in the CRM.
-
-Typically, the metadata endpoints are used to understand the structure of data (for dynamic integrations or form-building) rather than to manage actual records. They are read-only in most cases. Authentication is required for these as well (use your API key).

packages/twenty-docs/developers/api-and-webhooks/webhooks.mdx

@@ -1,82 +0,0 @@
----
-title: Webhooks
-image: /images/docs/getting-started/webhooks.png
-info: Discover how to use our Webhooks.
----
-<Frame>
-  <img src="/images/docs/getting-started/webhooks.png" alt="Header" />
-</Frame>
-
-## Overview
-Webhooks in Twenty complement the API by enabling **real-time notifications** to your own applications when certain events happen in your CRM. Instead of continuously polling the API for changes, you can set up webhooks to have Twenty **push** data to your system whenever specific events occur (for example, when a new record is created or an existing record is updated). This helps keep external systems in sync with Twenty instantly and efficiently.
-
-With webhooks, Twenty will send an HTTP POST request to a URL you specify, containing details about the event. You can then handle that data in your application (e.g., to update your external database, trigger workflows, or send alerts).
-
-## Setting Up a Webhook
-To create a webhook in Twenty, use the **APIs & Webhooks** settings in your Twenty app:
-
-1. **Navigate to Settings:** In your Twenty application, go to **Settings → APIs & Webhooks**.
-2. **Create a Webhook:** Under **Webhooks** click on **+ Create webhook**.
-3. **Enter URL:** Provide the endpoint URL on your server where you want Twenty to send webhook requests. This should be a publicly accessible URL that can handle POST requests.
-4. **Save:** Click **Save** to create the webhook. The new webhook will be active immediately.
-
-You can create multiple webhooks if you need to send different events to different endpoints. Each webhook is essentially a subscription for all relevant events (at this time, Twenty sends all event types to the given URL; filtering specific event types may be configurable in the UI). If you ever need to remove a webhook, you can delete it from the same settings page (select the webhook and choose delete).
-
-## Events and Payloads
-Once a webhook is set up, Twenty will send an HTTP POST request to your specified URL whenever a trigger event occurs in your CRM data. Common events that trigger webhooks include:
-
-* **Record Created:** e.g. a new person is added (`person.created`), a new company is created (`company.created`), a note is created (`note.created`), etc.
-* **Record Updated:** e.g. an existing person's information is updated (`person.updated`), a company record is edited (`company.updated`), etc.
-* **Record Deleted:** e.g. a person or company is deleted (`person.deleted`, `company.deleted`).
-* **Other Events:** If applicable, other object events or custom triggers (for instance, if tasks or other objects are updated, similar event types would be used like `task.created`, `note.updated`, etc.).
-
-The webhook POST request contains a JSON payload in its body. The payload will generally include at least two things: the type of event, and the data related to that event (often the record that was created/updated). For example, a webhook for a newly created person might send a payload like:
-
-```
-{
-  "event": "person.created",
-  "data": {
-    "id": "abc12345",
-    "firstName": "Alice",
-    "lastName": "Doe",
-    "email": "alice@example.com",
-    "createdAt": "2025-02-10T15:30:45Z",
-    "createdBy": "user_123"
-  },
-  "timestamp": "2025-02-10T15:30:50Z"
-}
-```
-
-In this example:
- 
-* `"event"` specifies what happened (`person.created`).
-* `"data"` contains the new record's details (the same information you would get if you requested that person via the API).
-* `"timestamp"` is when the event occurred (in UTC).
-
-Your endpoint should be prepared to receive such JSON data via POST. Typically, you'll parse the JSON, look at the `"event"` type to understand what happened, and then use the `"data"` accordingly (e.g., create a new contact in your system, or update an existing one).
- 
-**Note:** It's important to respond with a **2xx HTTP status** from your webhook endpoint to acknowledge successful receipt. If the Twenty webhook sender does not get a 2xx response, it may consider the delivery failed. (In the future, retry logic might attempt to resend failed webhooks, so always strive to return a 200 OK as quickly as possible after processing the data.)
-
-## Webhook Validation
-
-To ensure the security of your webhook endpoints, Twenty includes a signature in the `X-Twenty-Webhook-Signature` header. 
-
-This signature is an HMAC SHA256 hash of the request payload, computed using your webhook secret. 
-
-To validate the signature, you'll need to:
-1. Concatenate the timestamp (from `X-Twenty-Webhook-Timestamp` header), a colon, and the JSON string of the payload
-2. Compute the HMAC SHA256 hash using your webhook secret as the key ()
-3. Compare the resulting hex digest with the signature header
-
-Here's an example in Node.js:
-
-```javascript
-const crypto = require("crypto");
-const timestamp = "1735066639761";
-const payload = JSON.stringify({...});
-const secret = "your-secret";
-const stringToSign = `${timestamp}:${JSON.stringify(payload)}`;
-const signature = crypto.createHmac("sha256", secret)
-  .update(stringToSign)
-  .digest("hex");
-```

packages/twenty-docs/developers/backend-development/best-practices-server.mdx

@@ -1,27 +0,0 @@
----
-title: Best Practices
-image: /images/user-guide/tips/light-bulb.png
----
-<Frame>
-  <img src="/images/user-guide/tips/light-bulb.png" alt="Header" />
-</Frame>
-
-This document outlines the best practices you should follow when working on the backend.
-
-## Follow a modular approach
-
-The backend follows a modular approach, which is a fundamental principle when working with NestJS. Make sure you break down your code into reusable modules to maintain a clean and organized codebase. 
-Each module should encapsulate a particular feature or functionality and have a well-defined scope. This modular approach enables clear separation of concerns and removes unnecessary complexities.  
-
-## Expose services to use in modules
-
-Always create services that have a clear and single responsibility, which enhances code readability and maintainability. Name the services descriptively and consistently. 
-
-You should also expose services that you want to use in other modules. Exposing services to other modules is possible through NestJS's powerful dependency injection system, and promotes loose coupling between components. 
-
-## Avoid using `any` type
-
-When you declare a variable as `any`, TypeScript's type checker doesn't perform any type checking, making it possible to assign any type of values to the variable. TypeScript uses type inference to determine the type of variable based on the value. By declaring it as `any`, TypeScript can no longer infer the type. This makes it hard to catch type-related errors during development, leading to runtime errors and makes the code less maintainable, less reliable, and harder to understand for others.  
-
-This is why everything should have a type. So if you create a new object with a first name and last name, you should create an interface or type that contains a first name and last name that defines the shape of the object you are manipulating.
-

packages/twenty-docs/developers/backend-development/custom-objects.mdx

@@ -1,44 +0,0 @@
----
-title: Custom Objects
-image: /images/user-guide/objects/objects.png
----
-<Frame>
-  <img src="/images/user-guide/objects/objects.png" alt="Header" />
-</Frame>
-
-Objects are structures that allow you to store data (records, attributes, and values) specific to an organization. Twenty provides both standard and custom objects.
-
-Standard objects are in-built objects with a set of attributes available for all users. Examples of standard objects in Twenty include Company and Person. Standard objects have standard fields that are also available for all Twenty users, like Company.displayName.
-
-Custom objects are objects that you can create to store information that is unique to your organization. They are not built-in; members of your workspace can create and customize custom objects to hold information that standard objects aren't suitable for. 
-
-
-## High-level schema 
-
-<div style={{textAlign: 'center'}}>
-    <img src="/images/docs/server/custom-object-schema.png" alt="High level schema" />
-</div>
-
-<br/>
-
-## How it works
-
-Custom objects come from metadata tables that determine the shape, name, and type of the objects. All this information is present in the metadata schema database, consisting of tables:
-
-- **DataSource**: Details where the data is present.
-- **Object**: Describes the object and links to a DataSource.
-- **Field**: Outlines an Object's fields and connects to the Object.
-
-To add a custom object, the workspaceMember will query the /metadata API. This updates the metadata accordingly and computes a GraphQL schema based on the metadata, storing it in a GQL cache for later use.
-<div style={{textAlign: 'center'}}>
-    <img src="/images/docs/server/add-custom-objects.jpeg" alt="Query the /metadata API to add custom objects" />
-</div>
-
-<br/>
-
-To fetch data, the process involves making queries through the /graphql endpoint and passing them through the Query Resolver.
-<div style={{textAlign: 'center'}}>
-    <img src="/images/docs/server/custom-object-schema.png" alt="Query the /graphql endpoint to fetch data" />
-</div>
-
-

packages/twenty-docs/developers/backend-development/feature-flags.mdx

@@ -1,54 +0,0 @@
----
-title: Feature Flags
-image: /images/user-guide/table-views/table.png
----
-<Frame>
-  <img src="/images/user-guide/table-views/table.png" alt="Header" />
-</Frame>
-
-Feature flags are used to hide experimental features. For Twenty, they are set on workspace level and not on a user level.
-
-## Adding a new feature flag
-
-In `FeatureFlagKey.ts` add the feature flag:
-
-```ts
-type FeatureFlagKey =
-  | 'IS_FEATURENAME_ENABLED'
-  | ...;
-```
-
-Also add it to the enum in `feature-flag.entity.ts`:
-
-```ts
-enum FeatureFlagKeys {
-    IsFeatureNameEnabled = 'IS_FEATURENAME_ENABLED',
-    ...
-}
-```
-
-
-
-To apply a feature flag on a **backend** feature use:
-
-```ts
-@Gate({
-  featureFlag: 'IS_FEATURENAME_ENABLED',
-})
-```
-
-To apply a feature flag on a **frontend** feature use:
-
-```ts
-const isFeatureNameEnabled = useIsFeatureEnabled('IS_FEATURENAME_ENABLED');
-```
-
-
-## Configure feature flags for the deployment
-
-Change the corresponding record in the Table `core.featureFlag`:
-
-| id       | key                      | workspaceId   | value  |
-|----------|--------------------------|---------------|--------|
-|  Random  | `IS_FEATURENAME_ENABLED` |  WorkspaceID  | `true` |
-

packages/twenty-docs/developers/backend-development/folder-architecture-server.mdx

@@ -1,130 +0,0 @@
----
-title: Folder Architecture
-info: A detailed look into our server folder architecture
-image: /images/user-guide/fields/field.png
----
-<Frame>
-  <img src="/images/user-guide/fields/field.png" alt="Header" />
-</Frame>
-
-The backend directory structure is as follows:
-
-```
-server
-  └───ability
-  └───constants 
-  └───core
-  └───database
-  └───decorators
-  └───filters
-  └───guards
-  └───health
-  └───integrations
-  └───metadata
-  └───workspace
-  └───utils
-```
-
-## Ability
-
-Defines permissions and includes handlers for each entity.
-
-## Decorators 
-
-Defines custom decorators in NestJS for added functionality. 
-
-See [custom decorators](https://docs.nestjs.com/custom-decorators) for more details.
-
-## Filters
-
-Includes exception filters to handle exceptions that might occur in GraphQL endpoints. 
-
-## Guards
-
-See [guards](https://docs.nestjs.com/guards) for more details. 
-
-## Health
-
-Includes a publicly available REST API (healthz) that returns a JSON to confirm whether the database is working as expected.
-
-## Metadata
-
-Defines custom objects and makes available a GraphQL API (graphql/metadata).
-
-## Workspace
-
-Generates and serves custom GraphQL schema based on the metadata. 
-
-### Workspace Directory Structure 
-
-```
-workspace
-
-  └───workspace-schema-builder
-    └───factories 
-    └───graphql-types
-    └───database
-    └───interfaces
-    └───object-definitions
-    └───services
-    └───storage
-    └───utils
-  └───workspace-resolver-builder
-    └───factories
-    └───interfaces
-  └───workspace-query-builder
-    └───factories
-    └───interfaces
-  └───workspace-query-runner
-    └───interfaces
-    └───utils 
-  └───workspace-datasource
-  └───workspace-manager
-  └───workspace-migration-runner
-  └───utils 
-  └───workspace.module.ts   
-  └───workspace.factory.spec.ts    
-  └───workspace.factory.ts      
-```
-
-
-The root of the workspace directory includes the `workspace.factory.ts`, a file containing the `createGraphQLSchema` function. This function generates workspace-specific schema by using the metadata to tailor a schema for individual workspaces. By separating the schema and resolver construction, we use the `makeExecutableSchema` function, which combines these discrete elements. 
-
-This strategy is not just about organization, but also helps with optimization, such as caching generated type definitions to enhance performance and scalability.
-
-### Workspace Schema builder
-
-Generates the GraphQL schema, and includes:  
-
-#### Factories: 
-
-Specialised constructors to generate GraphQL-related constructs.  
-- The type.factory translates field metadata into GraphQL types using `TypeMapperService`.
-- The type-definition.factory creates GraphQL input or output objects derived from `objectMetadata`.
-
-#### GraphQL Types
-
-Includes enumerations, inputs, objects, and scalars, and serves as the building blocks for the schema construction.
-
-#### Interfaces and Object Definitions
-
-Contains the blueprints for GraphQL entities, and includes both predefined and custom types like `MONEY` or `URL`.
-
-#### Services
-
-Contains the service responsible for associating FieldMetadataType with its appropriate GraphQL scalar or query modifiers.
-
-#### Storage 
-
-Includes the `TypeDefinitionsStorage` class that contains reusable type definitions, preventing duplication of GraphQL types.
-
-### Workspace Resolver Builder 
-
-Creates resolver functions for querying and mutating the GraphQL schema.
-
-Each factory in this directory is responsible for producing a distinct resolver type, such as the `FindManyResolverFactory`, designed for adaptable application across various tables.
-
-### Workspace Query Runner 
-
-Runs the generated queries on the database and parses the result.
-

packages/twenty-docs/developers/backend-development/queue.mdx

@@ -1,46 +0,0 @@
----
-title: Message Queue
-image: /images/user-guide/emails/emails_header.png
----
-<Frame>
-  <img src="/images/user-guide/emails/emails_header.png" alt="Header" />
-</Frame>
-
-Queues facilitate async operations to be performed. They can be used for performing background tasks such as sending a welcome email on register.
-Each use case will have its own queue class extended from `MessageQueueServiceBase`.
-
-Currently, we only support `bull-mq`[bull-mq](https://bullmq.io/) as the queue driver.
-
-## Steps to create and use a new queue
-
-1. Add a queue name for your new queue under enum `MESSAGE_QUEUES`.
-2. Provide the factory implementation of the queue with the queue name as the dependency token.
-3. Inject the queue that you created in the required module/service with the queue name as the dependency token.
-4. Add worker class with token based injection just like producer.
-
-### Example usage
-```ts
-class Resolver {
-  constructor(@Inject(MESSAGE_QUEUES.custom) private queue: MessageQueueService) {}
-
-  async onSomeAction() {
-    //business logic
-    await this.queue.add(someData);
-  }
-}
-
-//async worker
-class CustomWorker {
-  constructor(@Inject(MESSAGE_QUEUES.custom) private queue: MessageQueueService) {
-    this.initWorker();
-  }
-
-  async initWorker() {
-    await this.queue.work(async ({ id, data }) => {
-      //worker logic
-    });
-  }
-}
-```
-
-

packages/twenty-docs/developers/backend-development/server-commands.mdx

@@ -1,103 +0,0 @@
----
-title: Backend Commands
-image: /images/user-guide/kanban-views/kanban.png
----
-<Frame>
-  <img src="/images/user-guide/kanban-views/kanban.png" alt="Header" />
-</Frame>
-
-## Useful commands
-
-These commands should be executed from packages/twenty-server folder.
-From any other folder you can run `npx nx {command} twenty-server` (or `npx nx run twenty-server:{command}`).
-
-### First time setup
-
-```
-npx nx database:reset twenty-server # setup the database with dev seeds
-```
-
-### Starting the server
-
-```
-npx nx run twenty-server:start
-```
-
-### Lint
-
-```
-npx nx run twenty-server:lint # pass --fix to fix lint errors
-```
-
-### Test
-
-```
-npx nx run twenty-server:test:unit          # run unit tests
-npx nx run twenty-server:test:integration   # run integration tests
-```
-Note: you can run `npx nx run twenty-server:test:integration:with-db-reset` in case you need to reset the database before running the integration tests.
-
-### Resetting the database
-
-If you want to reset and seed the database, you can run the following command:
-
-```bash
-npx nx run twenty-server:database:reset
-```
-
-### Migrations
-
-#### For objects in Core/Metadata schemas (TypeORM)
-
-```bash
-npx nx run twenty-server:typeorm migration:generate src/database/typeorm/core/migrations/nameOfYourMigration -d src/database/typeorm/core/core.datasource.ts
-```
-
-#### For Workspace objects
-
-There are no migrations files, migration are generated automatically for each workspace,
-stored in the database, and applied with this command
-
-```bash
-npx nx run twenty-server:command workspace:sync-metadata -f
-```
-
-<Warning>
-
-This will drop the database and re-run the migrations and seed.
-
-Make sure to back up any data you want to keep before running this command.
-
-</Warning>
-
-## Tech Stack
-
-Twenty primarily uses NestJS for the backend.
-
-Prisma was the first ORM we used. But in order to allow users to create custom fields and custom objects, a lower-level made more sense as we need to have fine-grained control. The project now uses TypeORM.
-
-Here's what the tech stack now looks like.
-
-
-**Core**
-- [NestJS](https://nestjs.com/)
-- [TypeORM](https://typeorm.io/)
-- [GraphQL Yoga](https://the-guild.dev/graphql/yoga-server)
-
-**Database**
-- [Postgres](https://www.postgresql.org/)
-
-**Third-party integrations**
-- [Sentry](https://sentry.io/welcome/) for tracking bugs
-
-**Testing**
-- [Jest](https://jestjs.io/)
-
-**Tooling**
-- [Yarn](https://yarnpkg.com/)
-- [ESLint](https://eslint.org/)
-
-**Development**
-- [AWS EKS](https://aws.amazon.com/eks/)
-
-

packages/twenty-docs/developers/backend-development/zapier.mdx

@@ -1,79 +0,0 @@
----
-title: Zapier App
-image: /images/user-guide/integrations/plug.png
----
-<Frame>
-  <img src="/images/user-guide/integrations/plug.png" alt="Header" />
-</Frame>
-
-Effortlessly sync Twenty with 3000+ apps using [Zapier](https://zapier.com/). Automate tasks, boost productivity, and supercharge your customer relationships!
-
-## About Zapier
-
-Zapier is a tool that allows you to automate workflows by connecting the apps that your team uses every day. The fundamental concept of Zapier is automation workflows, called Zaps, and include triggers and actions.
-
-You can learn more about how Zapier works [here](https://zapier.com/how-it-works).  
-
-## Setup
-
-### Step 1: Install Zapier packages
-
-```bash
-cd packages/twenty-zapier
-
-yarn
-```
-
-### Step 2: Login with the CLI
-
-Use your Zapier credentials to log in using the CLI: 
-
-```bash
-zapier login
-```
-
-### Step 3: Set environment variables
-
-From the `packages/twenty-zapier` folder, run:
-
-```bash
-cp .env.example .env
-```
-Run the application locally, go to [http://localhost:3000/settings/api-webhooks](http://localhost:3000/settings/api-webhooks), and generate an API key.
-
-Replace the **YOUR_API_KEY** value in the `.env` file with the API key you just generated.
-
-## Development
-
-<Warning>
-
-Make sure to run `yarn build` before any `zapier` command.
-
-</Warning>
-
-### Test
-```bash
-yarn test
-```
-### Lint
-```bash
-yarn format
-```
-### Watch and compile as you edit code
-```bash
-yarn watch
-```
-### Validate your Zapier app
-```bash
-yarn validate
-```
-### Deploy your Zapier app 
-```bash
-yarn deploy
-```
-### List all Zapier CLI commands
-```bash
-zapier
-``` 
-
-

packages/twenty-docs/developers/bug-and-requests.mdx

@@ -1,18 +0,0 @@
----
-title: Bugs and Requests
-image: /images/user-guide/api/api.png
-info: Ask for help on GitHub or Discord
----
-<Frame>
-  <img src="/images/user-guide/api/api.png" alt="Header" />
-</Frame>
-
-## Reporting Bugs
-To report a bug, please [create an issue on GitHub](https://github.com/twentyhq/twenty/issues/new).
-
-You can also ask for help on [Discord](https://discord.gg/cx5n4Jzs57).
-
-## Feature Requests
-
-If you're not sure if it's a bug, and you feel it's closer to a feature request, then you should probably [open a discussion instead](https://github.com/twentyhq/twenty/discussions/new).
-

packages/twenty-docs/developers/contribute/capabilities/backend-development/best-practices-server.mdx

@@ -0,0 +1,24 @@
+---
+title: Best Practices
+---
+
+
+This document outlines the best practices you should follow when working on the backend.
+
+## Follow a modular approach
+
+The backend follows a modular approach, which is a fundamental principle when working with NestJS. Make sure you break down your code into reusable modules to maintain a clean and organized codebase.
+Each module should encapsulate a particular feature or functionality and have a well-defined scope. This modular approach enables clear separation of concerns and removes unnecessary complexities.
+
+## Expose services to use in modules
+
+Always create services that have a clear and single responsibility, which enhances code readability and maintainability. Name the services descriptively and consistently.
+
+You should also expose services that you want to use in other modules. Exposing services to other modules is possible through NestJS's powerful dependency injection system, and promotes loose coupling between components.
+
+## Avoid using `any` type
+
+When you declare a variable as `any`, TypeScript's type checker doesn't perform any type checking, making it possible to assign any type of values to the variable. TypeScript uses type inference to determine the type of variable based on the value. By declaring it as `any`, TypeScript can no longer infer the type. This makes it hard to catch type-related errors during development, leading to runtime errors and makes the code less maintainable, less reliable, and harder to understand for others.
+
+This is why everything should have a type. So if you create a new object with a first name and last name, you should create an interface or type that contains a first name and last name that defines the shape of the object you are manipulating.
+

packages/twenty-docs/developers/contribute/capabilities/backend-development/custom-objects.mdx

@@ -0,0 +1,41 @@
+---
+title: Custom Objects
+---
+
+
+Objects are structures that allow you to store data (records, attributes, and values) specific to an organization. Twenty provides both standard and custom objects.
+
+Standard objects are in-built objects with a set of attributes available for all users. Examples of standard objects in Twenty include Company and Person. Standard objects have standard fields that are also available for all Twenty users, like Company.displayName.
+
+Custom objects are objects that you can create to store information that is unique to your organization. They are not built-in; members of your workspace can create and customize custom objects to hold information that standard objects aren't suitable for.
+
+
+## High-level schema
+
+<div style={{textAlign: 'center'}}>
+    <img src="/images/docs/server/custom-object-schema.png" alt="High level schema" />
+</div>
+
+<br/>
+
+## How it works
+
+Custom objects come from metadata tables that determine the shape, name, and type of the objects. All this information is present in the metadata schema database, consisting of tables:
+
+- **DataSource**: Details where the data is present.
+- **Object**: Describes the object and links to a DataSource.
+- **Field**: Outlines an Object's fields and connects to the Object.
+
+To add a custom object, the workspaceMember will query the /metadata API. This updates the metadata accordingly and computes a GraphQL schema based on the metadata, storing it in a GQL cache for later use.
+<div style={{textAlign: 'center'}}>
+    <img src="/images/docs/server/add-custom-objects.jpeg" alt="Query the /metadata API to add custom objects" />
+</div>
+
+<br/>
+
+To fetch data, the process involves making queries through the /graphql endpoint and passing them through the Query Resolver.
+<div style={{textAlign: 'center'}}>
+    <img src="/images/docs/server/custom-object-schema.png" alt="Query the /graphql endpoint to fetch data" />
+</div>
+
+

packages/twenty-docs/developers/contribute/capabilities/backend-development/feature-flags.mdx

@@ -0,0 +1,51 @@
+---
+title: Feature Flags
+---
+
+
+Feature flags are used to hide experimental features. For Twenty, they are set on workspace level and not on a user level.
+
+## Adding a new feature flag
+
+In `FeatureFlagKey.ts` add the feature flag:
+
+```ts
+type FeatureFlagKey =
+  | 'IS_FEATURENAME_ENABLED'
+  | ...;
+```
+
+Also add it to the enum in `feature-flag.entity.ts`:
+
+```ts
+enum FeatureFlagKeys {
+    IsFeatureNameEnabled = 'IS_FEATURENAME_ENABLED',
+    ...
+}
+```
+
+
+
+To apply a feature flag on a **backend** feature use:
+
+```ts
+@Gate({
+  featureFlag: 'IS_FEATURENAME_ENABLED',
+})
+```
+
+To apply a feature flag on a **frontend** feature use:
+
+```ts
+const isFeatureNameEnabled = useIsFeatureEnabled('IS_FEATURENAME_ENABLED');
+```
+
+
+## Configure feature flags for the deployment
+
+Change the corresponding record in the Table `core.featureFlag`:
+
+| id       | key                      | workspaceId   | value  |
+|----------|--------------------------|---------------|--------|
+|  Random  | `IS_FEATURENAME_ENABLED` |  WorkspaceID  | `true` |
+

packages/twenty-docs/developers/contribute/capabilities/backend-development/folder-architecture-server.mdx

@@ -0,0 +1,127 @@
+---
+title: Folder Architecture
+info: A detailed look into our server folder architecture
+---
+
+
+The backend directory structure is as follows:
+
+```
+server
+  └───ability
+  └───constants
+  └───core
+  └───database
+  └───decorators
+  └───filters
+  └───guards
+  └───health
+  └───integrations
+  └───metadata
+  └───workspace
+  └───utils
+```
+
+## Ability
+
+Defines permissions and includes handlers for each entity.
+
+## Decorators
+
+Defines custom decorators in NestJS for added functionality.
+
+See [custom decorators](https://docs.nestjs.com/custom-decorators) for more details.
+
+## Filters
+
+Includes exception filters to handle exceptions that might occur in GraphQL endpoints.
+
+## Guards
+
+See [guards](https://docs.nestjs.com/guards) for more details.
+
+## Health
+
+Includes a publicly available REST API (healthz) that returns a JSON to confirm whether the database is working as expected.
+
+## Metadata
+
+Defines custom objects and makes available a GraphQL API (graphql/metadata).
+
+## Workspace
+
+Generates and serves custom GraphQL schema based on the metadata.
+
+### Workspace Directory Structure
+
+```
+workspace
+
+  └───workspace-schema-builder
+    └───factories
+    └───graphql-types
+    └───database
+    └───interfaces
+    └───object-definitions
+    └───services
+    └───storage
+    └───utils
+  └───workspace-resolver-builder
+    └───factories
+    └───interfaces
+  └───workspace-query-builder
+    └───factories
+    └───interfaces
+  └───workspace-query-runner
+    └───interfaces
+    └───utils
+  └───workspace-datasource
+  └───workspace-manager
+  └───workspace-migration-runner
+  └───utils
+  └───workspace.module.ts
+  └───workspace.factory.spec.ts
+  └───workspace.factory.ts
+```
+
+
+The root of the workspace directory includes the `workspace.factory.ts`, a file containing the `createGraphQLSchema` function. This function generates workspace-specific schema by using the metadata to tailor a schema for individual workspaces. By separating the schema and resolver construction, we use the `makeExecutableSchema` function, which combines these discrete elements.
+
+This strategy is not just about organization, but also helps with optimization, such as caching generated type definitions to enhance performance and scalability.
+
+### Workspace Schema builder
+
+Generates the GraphQL schema, and includes:
+
+#### Factories:
+
+Specialised constructors to generate GraphQL-related constructs.
+- The type.factory translates field metadata into GraphQL types using `TypeMapperService`.
+- The type-definition.factory creates GraphQL input or output objects derived from `objectMetadata`.
+
+#### GraphQL Types
+
+Includes enumerations, inputs, objects, and scalars, and serves as the building blocks for the schema construction.
+
+#### Interfaces and Object Definitions
+
+Contains the blueprints for GraphQL entities, and includes both predefined and custom types like `MONEY` or `URL`.
+
+#### Services
+
+Contains the service responsible for associating FieldMetadataType with its appropriate GraphQL scalar or query modifiers.
+
+#### Storage
+
+Includes the `TypeDefinitionsStorage` class that contains reusable type definitions, preventing duplication of GraphQL types.
+
+### Workspace Resolver Builder
+
+Creates resolver functions for querying and mutating the GraphQL schema.
+
+Each factory in this directory is responsible for producing a distinct resolver type, such as the `FindManyResolverFactory`, designed for adaptable application across various tables.
+
+### Workspace Query Runner
+
+Runs the generated queries on the database and parses the result.
+

packages/twenty-docs/developers/contribute/capabilities/backend-development/queue.mdx

@@ -0,0 +1,43 @@
+---
+title: Message Queue
+---
+
+
+Queues facilitate async operations to be performed. They can be used for performing background tasks such as sending a welcome email on register.
+Each use case will have its own queue class extended from `MessageQueueServiceBase`.
+
+Currently, we only support `bull-mq`[bull-mq](https://bullmq.io/) as the queue driver.
+
+## Steps to create and use a new queue
+
+1. Add a queue name for your new queue under enum `MESSAGE_QUEUES`.
+2. Provide the factory implementation of the queue with the queue name as the dependency token.
+3. Inject the queue that you created in the required module/service with the queue name as the dependency token.
+4. Add worker class with token based injection just like producer.
+
+### Example usage
+```ts
+class Resolver {
+  constructor(@Inject(MESSAGE_QUEUES.custom) private queue: MessageQueueService) {}
+
+  async onSomeAction() {
+    //business logic
+    await this.queue.add(someData);
+  }
+}
+
+//async worker
+class CustomWorker {
+  constructor(@Inject(MESSAGE_QUEUES.custom) private queue: MessageQueueService) {
+    this.initWorker();
+  }
+
+  async initWorker() {
+    await this.queue.work(async ({ id, data }) => {
+      //worker logic
+    });
+  }
+}
+```
+
+

packages/twenty-docs/developers/contribute/capabilities/backend-development/server-commands.mdx

@@ -0,0 +1,100 @@
+---
+title: Backend Commands
+---
+
+
+## Useful commands
+
+These commands should be executed from packages/twenty-server folder.
+From any other folder you can run `npx nx {command} twenty-server` (or `npx nx run twenty-server:{command}`).
+
+### First time setup
+
+```
+npx nx database:reset twenty-server # setup the database with dev seeds
+```
+
+### Starting the server
+
+```
+npx nx run twenty-server:start
+```
+
+### Lint
+
+```
+npx nx run twenty-server:lint # pass --fix to fix lint errors
+```
+
+### Test
+
+```
+npx nx run twenty-server:test:unit          # run unit tests
+npx nx run twenty-server:test:integration   # run integration tests
+```
+Note: you can run `npx nx run twenty-server:test:integration:with-db-reset` in case you need to reset the database before running the integration tests.
+
+### Resetting the database
+
+If you want to reset and seed the database, you can run the following command:
+
+```bash
+npx nx run twenty-server:database:reset
+```
+
+### Migrations
+
+#### For objects in Core/Metadata schemas (TypeORM)
+
+```bash
+npx nx run twenty-server:typeorm migration:generate src/database/typeorm/core/migrations/nameOfYourMigration -d src/database/typeorm/core/core.datasource.ts
+```
+
+#### For Workspace objects
+
+There are no migrations files, migration are generated automatically for each workspace,
+stored in the database, and applied with this command
+
+```bash
+npx nx run twenty-server:command workspace:sync-metadata -f
+```
+
+<Warning>
+
+This will drop the database and re-run the migrations and seed.
+
+Make sure to back up any data you want to keep before running this command.
+
+</Warning>
+
+## Tech Stack
+
+Twenty primarily uses NestJS for the backend.
+
+Prisma was the first ORM we used. But in order to allow users to create custom fields and custom objects, a lower-level made more sense as we need to have fine-grained control. The project now uses TypeORM.
+
+Here's what the tech stack now looks like.
+
+
+**Core**
+- [NestJS](https://nestjs.com/)
+- [TypeORM](https://typeorm.io/)
+- [GraphQL Yoga](https://the-guild.dev/graphql/yoga-server)
+
+**Database**
+- [Postgres](https://www.postgresql.org/)
+
+**Third-party integrations**
+- [Sentry](https://sentry.io/welcome/) for tracking bugs
+
+**Testing**
+- [Jest](https://jestjs.io/)
+
+**Tooling**
+- [Yarn](https://yarnpkg.com/)
+- [ESLint](https://eslint.org/)
+
+**Development**
+- [AWS EKS](https://aws.amazon.com/eks/)
+
+

packages/twenty-docs/developers/contribute/capabilities/backend-development/zapier.mdx

@@ -0,0 +1,76 @@
+---
+title: Zapier App
+---
+
+
+Effortlessly sync Twenty with 3000+ apps using [Zapier](https://zapier.com/). Automate tasks, boost productivity, and supercharge your customer relationships!
+
+## About Zapier
+
+Zapier is a tool that allows you to automate workflows by connecting the apps that your team uses every day. The fundamental concept of Zapier is automation workflows, called Zaps, and include triggers and actions.
+
+You can learn more about how Zapier works [here](https://zapier.com/how-it-works).
+
+## Setup
+
+### Step 1: Install Zapier packages
+
+```bash
+cd packages/twenty-zapier
+
+yarn
+```
+
+### Step 2: Login with the CLI
+
+Use your Zapier credentials to log in using the CLI:
+
+```bash
+zapier login
+```
+
+### Step 3: Set environment variables
+
+From the `packages/twenty-zapier` folder, run:
+
+```bash
+cp .env.example .env
+```
+Run the application locally, go to [http://localhost:3000/settings/api-webhooks](http://localhost:3000/settings/api-webhooks), and generate an API key.
+
+Replace the **YOUR_API_KEY** value in the `.env` file with the API key you just generated.
+
+## Development
+
+<Warning>
+
+Make sure to run `yarn build` before any `zapier` command.
+
+</Warning>
+
+### Test
+```bash
+yarn test
+```
+### Lint
+```bash
+yarn format
+```
+### Watch and compile as you edit code
+```bash
+yarn watch
+```
+### Validate your Zapier app
+```bash
+yarn validate
+```
+### Deploy your Zapier app
+```bash
+yarn deploy
+```
+### List all Zapier CLI commands
+```bash
+zapier
+```
+
+

packages/twenty-docs/developers/contribute/capabilities/bug-and-requests.mdx

@@ -0,0 +1,76 @@
+---
+title: Bugs, Requests & Pull Requests
+info: Report issues, request features, and contribute code
+---
+
+
+## Reporting Bugs
+
+To report a bug, please [create an issue on GitHub](https://github.com/twentyhq/twenty/issues/new).
+
+You can also ask for help on [Discord](https://discord.gg/cx5n4Jzs57).
+
+## Feature Requests
+
+If you're not sure if it's a bug, and you feel it's closer to a feature request, then you should probably [open a discussion instead](https://github.com/twentyhq/twenty/discussions/new).
+
+## Submit a Pull Request
+
+Contributing code to Twenty starts with a pull request (PR).
+
+### Before You Start
+
+1. Check [existing issues](https://github.com/twentyhq/twenty/issues) for related work
+2. For new features, open an issue first to discuss
+3. Review our [Code of Conduct](https://github.com/twentyhq/twenty/blob/main/CODE_OF_CONDUCT.md)
+
+### Fork and Clone
+
+1. Fork the repository on GitHub
+2. Clone your fork:
+```bash
+git clone https://github.com/YOUR_USERNAME/twenty.git
+cd twenty
+```
+
+3. Add upstream remote:
+```bash
+git remote add upstream https://github.com/twentyhq/twenty.git
+```
+
+### Create a Branch
+
+```bash
+git checkout -b feature/your-feature-name
+```
+
+Use descriptive branch names:
+- `feature/add-export-button`
+- `fix/login-redirect-issue`
+- `docs/update-api-guide`
+
+### Make Your Changes
+
+1. Write clean, well-documented code
+2. Follow existing code style
+3. Add tests for new functionality
+4. Update documentation if needed
+
+### Submit Your PR
+
+1. Push your branch:
+```bash
+git push origin feature/your-feature-name
+```
+
+2. Open a PR on GitHub
+3. Fill in the PR template
+4. Link related issues
+
+### PR Checklist
+
+- [ ] Code follows project style guidelines
+- [ ] Tests pass locally
+- [ ] Documentation is updated
+- [ ] PR description explains the changes
+

packages/twenty-docs/developers/contribute/capabilities/frontend-development/best-practices-front.mdx

@@ -0,0 +1,329 @@
+---
+title: Best Practices
+---
+
+
+This document outlines the best practices you should follow when working on the frontend.
+
+## State management
+
+React and Recoil handle state management in the codebase.
+
+### Use `useRecoilState` to store state
+
+It's good practice to create as many atoms as you need to store your state.
+
+<Warning>
+
+It's better to use extra atoms than trying to be too concise with props drilling.
+
+</Warning>
+
+```tsx
+export const myAtomState = atom({
+  key: 'myAtomState',
+  default: 'default value',
+});
+
+export const MyComponent = () => {
+  const [myAtom, setMyAtom] = useRecoilState(myAtomState);
+
+  return (
+    <div>
+      <input
+        value={myAtom}
+        onChange={(e) => setMyAtom(e.target.value)}
+      />
+    </div>
+  );
+}
+```
+
+### Do not use `useRef` to store state
+
+Avoid using `useRef` to store state.
+
+If you want to store state, you should use `useState` or `useRecoilState`.
+
+See [how to manage re-renders](#managing-re-renders) if you feel like you need `useRef` to prevent some re-renders from happening.
+
+## Managing re-renders
+
+Re-renders can be hard to manage in React.
+
+Here are some rules to follow to avoid unnecessary re-renders.
+
+Keep in mind that you can **always** avoid re-renders by understanding their cause.
+
+### Work at the root level
+
+Avoiding re-renders in new features is now made easy by eliminating them at the root level.
+
+The `PageChangeEffect` sidecar component contains just one `useEffect` that holds all the logic to execute on a page change.
+
+That way you know that there's just one place that can trigger a re-render.
+
+### Always think twice before adding `useEffect` in your codebase
+
+Re-renders are often caused by unnecessary `useEffect`.
+
+You should think whether you need `useEffect`, or if you can move the logic in a event handler function.
+
+You'll find it generally easy to move the logic in a `handleClick` or `handleChange` function.
+
+You can also find them in libraries like Apollo: `onCompleted`, `onError`, etc.
+
+### Use a sibling component to extract `useEffect` or data fetching logic
+
+If you feel like you need to add a `useEffect` in your root component, you should consider extracting it in a sidecar component.
+
+You can apply the same for data fetching logic, with Apollo hooks.
+
+```tsx
+// ❌ Bad, will cause re-renders even if data is not changing,
+//    because useEffect needs to be re-evaluated
+export const PageComponent = () => {
+  const [data, setData] = useRecoilState(dataState);
+  const [someDependency] = useRecoilState(someDependencyState);
+
+  useEffect(() => {
+    if(someDependency !== data) {
+      setData(someDependency);
+    }
+  }, [someDependency]);
+
+  return <div>{data}</div>;
+};
+
+export const App = () => (
+  <RecoilRoot>
+    <PageComponent />
+  </RecoilRoot>
+);
+```
+
+```tsx
+// ✅ Good, will not cause re-renders if data is not changing,
+//   because useEffect is re-evaluated in another sibling component
+export const PageComponent = () => {
+  const [data, setData] = useRecoilState(dataState);
+
+  return <div>{data}</div>;
+};
+
+export const PageData = () => {
+  const [data, setData] = useRecoilState(dataState);
+  const [someDependency] = useRecoilState(someDependencyState);
+
+  useEffect(() => {
+    if(someDependency !== data) {
+      setData(someDependency);
+    }
+  }, [someDependency]);
+
+  return <></>;
+};
+
+export const App = () => (
+  <RecoilRoot>
+    <PageData />
+    <PageComponent />
+  </RecoilRoot>
+);
+```
+
+### Use recoil family states and recoil family selectors
+
+Recoil family states and selectors are a great way to avoid re-renders.
+
+They are useful when you need to store a list of items.
+
+### You shouldn't use `React.memo(MyComponent)`
+
+Avoid using `React.memo()` because it does not solve the cause of the re-render, but instead breaks the re-render chain, which can lead to unexpected behavior and make the code very hard to refactor.
+
+### Limit `useCallback` or `useMemo` usage
+
+They are often not necessary and will make the code harder to read and maintain for a gain of performance that is unnoticeable.
+
+## Console.logs
+
+`console.log` statements are valuable during development, offering real-time insights into variable values and code flow. But, leaving them in production code can lead to several issues:
+
+1. **Performance**: Excessive logging can affect the runtime performance, especially on client-side applications.
+
+2. **Security**: Logging sensitive data can expose critical information to anyone who inspects the browser's console.
+
+3. **Cleanliness**: Filling up the console with logs can obscure important warnings or errors that developers or tools need to see.
+
+4. **Professionalism**: End users or clients checking the console and seeing a myriad of log statements might question the code's quality and polish.
+
+Make sure you remove all `console.logs` before pushing the code to production.
+
+## Naming
+
+### Variable Naming
+
+Variable names ought to precisely depict the purpose or function of the variable.
+
+#### The issue with generic names
+Generic names in programming are not ideal because they lack specificity, leading to ambiguity and reduced code readability. Such names fail to convey the variable or function's purpose, making it challenging for developers to understand the code's intent without deeper investigation. This can result in increased debugging time, higher susceptibility to errors, and difficulties in maintenance and collaboration. Meanwhile, descriptive naming makes the code self-explanatory and easier to navigate, enhancing code quality and developer productivity.
+
+```tsx
+// ❌ Bad, uses a generic name that doesn't communicate its
+//    purpose or content clearly
+const [value, setValue] = useState('');
+```
+
+```tsx
+// ✅ Good, uses a descriptive name
+const [email, setEmail] = useState('');
+```
+
+#### Some words to avoid in variable names
+
+ - dummy
+
+### Event handlers
+
+Event handler names should start with `handle`, while `on` is a prefix used to name events in components props.
+
+```tsx
+// ❌ Bad
+const onEmailChange = (val: string) => {
+  // ...
+};
+```
+
+```tsx
+// ✅ Good
+const handleEmailChange = (val: string) => {
+  // ...
+};
+```
+
+## Optional Props
+
+Avoid passing the default value for an optional prop.
+
+**EXAMPLE**
+
+Take the`EmailField` component defined below:
+
+```tsx
+type EmailFieldProps = {
+  value: string;
+  disabled?: boolean;
+};
+
+const EmailField = ({ value, disabled = false }: EmailFieldProps) => (
+  <TextInput value={value} disabled={disabled} fullWidth />
+);
+```
+
+**Usage**
+
+```tsx
+// ❌ Bad, passing in the same value as the default value adds no value
+const Form = () => <EmailField value="username@email.com" disabled={false} />;
+```
+
+```tsx
+// ✅ Good, assumes the default value
+const Form = () => <EmailField value="username@email.com" />;
+```
+
+## Component as props
+
+Try as much as possible to pass uninstantiated components as props, so children can decide on their own of what props they need to pass.
+
+The most common example for that is icon components:
+
+```tsx
+const SomeParentComponent = () => <MyComponent Icon={MyIcon} />;
+
+// In MyComponent
+const MyComponent = ({ MyIcon }: { MyIcon: IconComponent }) => {
+  const theme = useTheme();
+
+  return (
+    <div>
+      <MyIcon size={theme.icon.size.md}>
+    </div>
+  )
+};
+```
+
+For React to understand that the component is a component, you need to use PascalCase, to later instantiate it with `<MyIcon>`
+
+## Prop Drilling: Keep It Minimal
+
+Prop drilling, in the React context, refers to the practice of passing state variables and their setters through many component layers, even if intermediary components don't use them. While sometimes necessary, excessive prop drilling can lead to:
+
+1. **Decreased Readability**: Tracing where a prop originates or where it's utilized can become convoluted in a deeply nested component structure.
+
+2. **Maintenance Challenges**: Changes in one component's prop structure might require adjustments in several components, even if they don't directly use the prop.
+
+3. **Reduced Component Reusability**: A component receiving a lot of props solely for passing them down becomes less general-purpose and harder to reuse in different contexts.
+
+If you feel that you are using excessive prop drilling, see [state management best practices](#state-management).
+
+## Imports
+
+When importing, opt for the designated aliases rather than specifying complete or relative paths.
+
+**The Aliases**
+
+```js
+{
+  alias: {
+    "~": path.resolve(__dirname, "src"),
+    "@": path.resolve(__dirname, "src/modules"),
+    "@testing": path.resolve(__dirname, "src/testing"),
+  },
+}
+```
+
+**Usage**
+```tsx
+// ❌ Bad, specifies the entire relative path
+import {
+  CatalogDecorator
+} from '../../../../../testing/decorators/CatalogDecorator';
+import {
+  ComponentDecorator
+} from '../../../../../testing/decorators/ComponentDecorator';
+```
+
+```tsx
+// ✅ Good, utilises the designated aliases
+import { CatalogDecorator } from '~/testing/decorators/CatalogDecorator';
+import { ComponentDecorator } from 'twenty-ui/testing';
+```
+
+## Schema Validation
+
+[Zod](https://github.com/colinhacks/zod) is the schema validator for untyped objects:
+
+```js
+const validationSchema = z
+  .object({
+    exist: z.boolean(),
+    email: z
+      .string()
+      .email('Email must be a valid email'),
+    password: z
+      .string()
+      .regex(PASSWORD_REGEX, 'Password must contain at least 8 characters'),
+  })
+  .required();
+
+type Form = z.infer<typeof validationSchema>;
+```
+
+
+## Breaking Changes
+
+Always perform thorough manual testing before proceeding to guarantee that modifications haven’t caused disruptions elsewhere, given that tests have not yet been extensively integrated.
+
+

packages/twenty-docs/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx

@@ -0,0 +1,112 @@
+---
+title: Folder Architecture
+info: A detailed look into our folder architecture
+---
+
+
+In this guide, you will explore the details of the project directory structure and how it contributes to the organization and maintainability of Twenty.
+
+By following this folder architecture convention, it's easier to find the files related to specific features and ensure that the application is scalable and maintainable.
+
+```
+front
+└───modules
+│   └───module1
+│   │   └───submodule1
+│   └───module2
+│   └───ui
+│   │   └───display
+│   │   └───inputs
+│   │   │   └───buttons
+│   │   └───...
+└───pages
+└───...
+```
+
+## Pages
+
+Includes the top-level components defined by the application routes. They import more low-level components from the modules folder (more details below).
+
+## Modules
+
+Each module represents a feature or a group of feature, comprising its specific components, states, and operational logic.
+They should all follow the structure below. You can nest modules within modules (referred to as submodules) and the same rules will apply.
+
+```
+module1
+  └───components
+  │   └───component1
+  │   └───component2
+  └───constants
+  └───contexts
+  └───graphql
+  │   └───fragments
+  │   └───queries
+  │   └───mutations
+  └───hooks
+  │   └───internal
+  └───states
+  │   └───selectors
+  └───types
+  └───utils
+```
+
+### Contexts
+
+A context is a way to pass data through the component tree without having to pass props down manually at every level.
+
+See [React Context](https://react.dev/reference/react#context-hooks) for more details.
+
+### GraphQL
+
+Includes fragments, queries, and mutations.
+
+See [GraphQL](https://graphql.org/learn/) for more details.
+
+- Fragments
+
+A fragment is a reusable piece of a query, which you can use in different places. By using fragments, it's easier to avoid duplicating code.
+
+See [GraphQL Fragments](https://graphql.org/learn/queries/#fragments) for more details.
+
+- Queries
+
+See [GraphQL Queries](https://graphql.org/learn/queries/) for more details.
+
+- Mutations
+
+See [GraphQL Mutations](https://graphql.org/learn/queries/#mutations) for more details.
+
+### Hooks
+
+See [Hooks](https://react.dev/learn/reusing-logic-with-custom-hooks) for more details.
+
+### States
+
+Contains the state management logic. [RecoilJS](https://recoiljs.org) handles this.
+
+- Selectors: See [RecoilJS Selectors](https://recoiljs.org/docs/basic-tutorial/selectors) for more details.
+
+React's built-in state management still handles state within a component.
+
+### Utils
+
+Should just contain reusable pure functions. Otherwise, create custom hooks in the `hooks` folder.
+
+
+## UI
+
+Contains all the reusable UI components used in the application.
+
+This folder can contain sub-folders, like `data`, `display`, `feedback`, and `input` for specific types of components. Each component should be self-contained and reusable, so that you can use it in different parts of the application.
+
+By separating the UI components from the other components in the `modules` folder, it's easier to maintain a consistent design and to make changes to the UI without affecting other parts (business logic) of the codebase.
+
+## Interface and dependencies
+
+You can import other module code from any module except for the `ui` folder. This will keep its code easy to test.
+
+### Internal
+
+Each part (hooks, states, ...) of a module can have an `internal` folder, which contains parts that are just used within the module.
+

packages/twenty-docs/developers/contribute/capabilities/frontend-development/frontend-commands.mdx

@@ -0,0 +1,91 @@
+---
+title: Frontend Commands
+---
+
+
+## Useful commands
+
+### Starting the app
+
+```bash
+npx nx start twenty-front
+```
+
+### Regenerate graphql schema based on API graphql schema
+
+```bash
+npx nx run twenty-front:graphql:generate --configuration=metadata
+```
+OR
+```bash
+npx nx run twenty-front:graphql:generate
+```
+
+### Lint
+
+```bash
+npx nx run twenty-front:lint # pass --fix to fix lint errors
+```
+
+## Translations
+
+```bash
+npx nx run twenty-front:lingui:extract
+npx nx run twenty-front:lingui:compile
+```
+
+### Test
+
+```bash
+npx nx run twenty-front:test # run jest tests
+npx nx run twenty-front:storybook:serve:dev # run storybook
+npx nx run twenty-front:storybook:test # run tests # (needs yarn storybook:serve:dev to be running)
+npx nx run twenty-front:storybook:coverage # (needs yarn storybook:serve:dev to be running)
+```
+
+## Tech Stack
+
+The project has a clean and simple stack, with minimal boilerplate code.
+
+**App**
+
+- [React](https://react.dev/)
+- [Apollo](https://www.apollographql.com/docs/)
+- [GraphQL Codegen](https://the-guild.dev/graphql/codegen)
+- [Recoil](https://recoiljs.org/docs/introduction/core-concepts)
+- [TypeScript](https://www.typescriptlang.org/)
+
+**Testing**
+
+- [Jest](https://jestjs.io/)
+- [Storybook](https://storybook.js.org/)
+
+**Tooling**
+
+- [Yarn](https://yarnpkg.com/)
+- [Craco](https://craco.js.org/docs/)
+- [ESLint](https://eslint.org/)
+
+## Architecture
+
+### Routing
+
+[React Router](https://reactrouter.com/) handles the routing.
+
+To avoid unnecessary [re-renders](/developers/contribute/capabilities/frontend-development/best-practices-front#managing-re-renders) all the routing logic is in a `useEffect` in `PageChangeEffect`.
+
+### State Management
+
+[Recoil](https://recoiljs.org/docs/introduction/core-concepts) handles state management.
+
+See [best practices](/developers/contribute/capabilities/frontend-development/best-practices-front#state-management) for more information on state management.
+
+## Testing
+
+[Jest](https://jestjs.io/) serves as the tool for unit testing while [Storybook](https://storybook.js.org/) is for component testing.
+
+Jest is mainly for testing utility functions, and not components themselves.
+
+Storybook is for testing the behavior of isolated components, as well as displaying the design system.
+
+

packages/twenty-docs/developers/contribute/capabilities/frontend-development/hotkeys.mdx

@@ -0,0 +1,177 @@
+---
+title: Hotkeys
+---
+
+
+## Introduction
+
+When you need to listen to a hotkey, you would normally use the `onKeyDown` event listener.
+
+In `twenty-front` however, you might have conflicts between same hotkeys that are used in different components, mounted at the same time.
+
+For example, if you have a page that listens for the Enter key, and a modal that listens for the Enter key, with a Select component inside that modal that listens for the Enter key, you might have a conflict when all are mounted at the same time.
+
+## The `useScopedHotkeys` hook
+
+To handle this problem, we have a custom hook that makes it possible to listen to hotkeys without any conflict.
+
+You place it in a component, and it will listen to the hotkeys only when the component is mounted AND when the specified **hotkey scope** is active.
+
+## How to listen for hotkeys in practice?
+
+There are two steps involved in setting up hotkey listening :
+1. Set the [hotkey scope](#what-is-a-hotkey-scope-) that will listen to hotkeys
+2. Use the `useScopedHotkeys` hook to listen to hotkeys
+
+Setting up hotkey scopes is required even in simple pages, because other UI elements like left menu or command menu might also listen to hotkeys.
+
+## Use cases for hotkeys
+
+In general, you'll have two use cases that require hotkeys :
+1. In a page or a component mounted in a page
+2. In a modal-type component that takes the focus due to a user action
+
+The second use case can happen recursively : a dropdown in a modal for example.
+
+### Listening to hotkeys in a page
+
+Example :
+
+```tsx
+const PageListeningEnter = () => {
+  const {
+    setHotkeyScopeAndMemorizePreviousScope,
+    goBackToPreviousHotkeyScope,
+  } = usePreviousHotkeyScope();
+
+  // 1. Set the hotkey scope in a useEffect
+  useEffect(() => {
+    setHotkeyScopeAndMemorizePreviousScope(
+      ExampleHotkeyScopes.ExampleEnterPage,
+    );
+
+    // Revert to the previous hotkey scope when the component is unmounted
+    return () => {
+      goBackToPreviousHotkeyScope();
+    };
+  }, [goBackToPreviousHotkeyScope, setHotkeyScopeAndMemorizePreviousScope]);
+
+  // 2. Use the useScopedHotkeys hook
+  useScopedHotkeys(
+    Key.Enter,
+    () => {
+      // Some logic executed on this page when the user presses Enter
+      // ...
+    },
+    ExampleHotkeyScopes.ExampleEnterPage,
+  );
+
+  return <div>My page that listens for Enter</div>;
+};
+```
+
+### Listening to hotkeys in a modal-type component
+
+For this example we'll use a modal component that listens for the Escape key to tell its parent to close it.
+
+Here the user interaction is changing the scope.
+
+```tsx
+const ExamplePageWithModal = () => {
+  const [showModal, setShowModal] = useState(false);
+
+  const {
+    setHotkeyScopeAndMemorizePreviousScope,
+    goBackToPreviousHotkeyScope,
+  } = usePreviousHotkeyScope();
+
+  const handleOpenModalClick = () => {
+    // 1. Set the hotkey scope when user opens the modal
+    setShowModal(true);
+    setHotkeyScopeAndMemorizePreviousScope(
+      ExampleHotkeyScopes.ExampleModal,
+    );
+  };
+
+  const handleModalClose = () => {
+    // 1. Revert to the previous hotkey scope when the modal is closed
+    setShowModal(false);
+    goBackToPreviousHotkeyScope();
+  };
+
+  return <div>
+    <h1>My page with a modal</h1>
+    <button onClick={handleOpenModalClick}>Open modal</button>
+    {showModal && <MyModalComponent onClose={handleModalClose} />}
+  </div>;
+};
+```
+
+Then in the modal component :
+
+```tsx
+const MyDropdownComponent = ({ onClose }: { onClose: () => void }) => {
+  // 2. Use the useScopedHotkeys hook to listen for Escape.
+  // Note that escape is a common hotkey that could be used by many other components
+  // So it's important to use a hotkey scope to avoid conflicts
+  useScopedHotkeys(
+    Key.Escape,
+    () => {
+      onClose()
+    },
+    ExampleHotkeyScopes.ExampleModal,
+  );
+
+  return <div>My modal component</div>;
+};
+```
+
+It's important to use this pattern when you're not sure that just using a useEffect with mount/unmount will be enough to avoid conflicts.
+
+Those conflicts can be hard to debug, and it might happen more often than not with useEffects.
+
+## What is a hotkey scope?
+
+A hotkey scope is a string that represents a context in which the hotkeys are active. It is generally encoded as an enum.
+
+When you change the hotkey scope, the hotkeys that are listening to this scope will be enabled and the hotkeys that are listening to other scopes will be disabled.
+
+You can set only one scope at a time.
+
+As an example, the hotkey scopes for each page are defined in the `PageHotkeyScope` enum:
+
+```tsx
+export enum PageHotkeyScope {
+  Settings = 'settings',
+  CreateWorkspace = 'create-workspace',
+  SignInUp = 'sign-in-up',
+  CreateProfile = 'create-profile',
+  PlanRequired = 'plan-required',
+  ShowPage = 'show-page',
+  PersonShowPage = 'person-show-page',
+  CompanyShowPage = 'company-show-page',
+  CompaniesPage = 'companies-page',
+  PeoplePage = 'people-page',
+  OpportunitiesPage = 'opportunities-page',
+  ProfilePage = 'profile-page',
+  WorkspaceMemberPage = 'workspace-member-page',
+  TaskPage = 'task-page',
+}
+```
+
+Internally, the currently selected scope is stored in a Recoil state that is shared across the application :
+
+```tsx
+export const currentHotkeyScopeState = createState<HotkeyScope>({
+  key: 'currentHotkeyScopeState',
+  defaultValue: INITIAL_HOTKEYS_SCOPE,
+});
+```
+
+But this Recoil state should never be handled manually ! We'll see how to use it in the next section.
+
+## How is it working internally?
+
+We made a thin wrapper on top of [react-hotkeys-hook](https://react-hotkeys-hook.vercel.app/docs/intro) that makes it more performant and avoids unnecessary re-renders.
+
+We also create a Recoil state to handle the hotkey scope state and make it available everywhere in the application.