Reorganize onboarding and add Kuma AI (baserow#4606)

Author: bram2w

backend/src/baserow/api/user/serializers.py

@@ -471,3 +471,7 @@ class ShareOnboardingDetailsWithBaserowSerializer(serializers.Serializer):
         help_text="The country that the user has chosen during the onboarding.",
         required=True,
     )
+    how = serializers.CharField(
+        help_text="How the user found Baserow.",
+        required=True,
+    )

backend/src/baserow/api/user/views.py

@@ -863,7 +863,12 @@ class ShareOnboardingDetailsWithBaserowView(APIView):
     @validate_body(ShareOnboardingDetailsWithBaserowSerializer)
     def post(self, request, data):
         UserHandler().start_share_onboarding_details_with_baserow(
-            request.user, data["team"], data["role"], data["size"], data["country"]
+            request.user,
+            data["team"],
+            data["role"],
+            data["size"],
+            data["country"],
+            data["how"],
         )
 
         return Response(status=204)

backend/src/baserow/core/user/handler.py

@@ -945,7 +945,13 @@ def send_email():
         )(send_email)()
 
     def start_share_onboarding_details_with_baserow(
-        self, user, team: str, role: str, size: str, country: str
+        self,
+        user,
+        team: str,
+        role: str,
+        size: str,
+        country: str,
+        how: str,
     ):
         """
         Starts a celery task that shares some user information with baserow.io. Note
@@ -962,10 +968,17 @@ def start_share_onboarding_details_with_baserow(
         email = user.email
 
         share_onboarding_details_with_baserow.delay(
-            email=email, team=team, role=role, size=size, country=country
+            email=email,
+            team=team,
+            role=role,
+            size=size,
+            country=country,
+            how=how,
         )
 
-    def share_onboarding_details_with_baserow(self, email, team, role, size, country):
+    def share_onboarding_details_with_baserow(
+        self, email, team, role, size, country, how
+    ):
         """
         Makes an API request to baserow.io that shares the additional information. Note
         that this is only triggered if the user given permission during the onboarding
@@ -975,6 +988,7 @@ def share_onboarding_details_with_baserow(self, email, team, role, size, country
         :param role: The role that the user shared.
         :param size: The company size that the user shared.
         :param country: The country name that the user shared.
+        :param how: How the user found Baserow.
         """
 
         settings_object = CoreHandler().get_settings()
@@ -990,6 +1004,7 @@ def share_onboarding_details_with_baserow(self, email, team, role, size, country
                     "size": size,
                     "country": country,
                     "email": email,
+                    "how": how,
                     "instance_id": settings_object.instance_id,
                 },
                 timeout=settings.ADDITIONAL_INFORMATION_TIMEOUT_SECONDS,

backend/tests/baserow/api/users/test_user_views.py

@@ -1247,6 +1247,7 @@ def test_share_onboarding_details_with_baserow(mock_task, client, data_fixture):
             "role": "CEO",
             "size": "11 - 50",
             "country": "The Netherlands",
+            "how": "Google",
         },
         format="json",
         HTTP_AUTHORIZATION=f"JWT {token}",
@@ -1260,6 +1261,7 @@ def test_share_onboarding_details_with_baserow(mock_task, client, data_fixture):
         role="CEO",
         size="11 - 50",
         country="The Netherlands",
+        how="Google",
     )
 
 

backend/tests/baserow/core/user/test_user_handler.py

@@ -792,7 +792,7 @@ def test_start_share_onboarding_details_with_baserow(mock_task, data_fixture):
     user = data_fixture.create_user()
 
     UserHandler().start_share_onboarding_details_with_baserow(
-        user, "Marketing", "CEO", "11 - 50", "The Netherlands"
+        user, "Marketing", "CEO", "11 - 50", "The Netherlands", "Google"
     )
 
     mock_task.delay.assert_called_with(
@@ -801,6 +801,7 @@ def test_start_share_onboarding_details_with_baserow(mock_task, data_fixture):
         role="CEO",
         size="11 - 50",
         country="The Netherlands",
+        how="Google",
     )
 
 
@@ -822,6 +823,7 @@ def test_share_onboarding_details_with_baserow_valid_response(data_fixture):
                     "role": "CEO",
                     "size": "11 - 50",
                     "country": "The Netherlands",
+                    "how": "Google",
                     "instance_id": "1",
                 }
             )
@@ -834,6 +836,7 @@ def test_share_onboarding_details_with_baserow_valid_response(data_fixture):
         role="CEO",
         size="11 - 50",
         country="The Netherlands",
+        how="Google",
     )
 
     assert response1.call_count == 1

changelog/entries/unreleased/feature/add_kuma_to_onboarding_and_reorganize.json

@@ -0,0 +1,9 @@
+{
+  "type": "feature",
+  "message": "Add Kuma to onboarding and reorganize the steps.",
+  "issue_origin": "github",
+  "issue_number": null,
+  "domain": "core",
+  "bullet_points": [],
+  "created_at": "2026-01-30"
+}

enterprise/web-frontend/modules/baserow_enterprise/assets/scss/components/all.scss

@@ -22,4 +22,5 @@
 @import 'file_input_element_form';
 @import 'custom_code';
 @import 'assistant';
+@import 'assistant_onboarding';
 @import 'date_dependency';

enterprise/web-frontend/modules/baserow_enterprise/assets/scss/components/assistant_onboarding.scss

@@ -0,0 +1,55 @@
+.assistant-onboarding {
+  margin-top: 20px;
+  width: 360px;
+  height: 210px;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+}
+
+.assistant-onboarding__logo {
+  margin-bottom: 10px;
+}
+
+.assistant-onboarding__title {
+  font-size: 20px;
+  font-weight: 500;
+  color: $palette-neutral-1200;
+  margin-bottom: 32px;
+  display: flex;
+  align-items: center;
+}
+
+.assistant-onboarding__title-icon {
+  color: $palette-cyan-700;
+  margin-right: 6px;
+}
+
+.assistant-onboarding__message {
+  display: flex;
+  background-color: $palette-cyan-50;
+  border: 1px solid $palette-cyan-200;
+  border-radius: 12px;
+  padding: 12px 16px;
+  overflow-wrap: break-word;
+  width: 100%;
+}
+
+.assistant-onboarding__loading-wrapper {
+  flex: 0 0 28px;
+  width: 28px;
+}
+
+.assistant-onboarding__loading {
+  @include loading(1.4rem, $palette-cyan-500);
+}
+
+.assistant-onboarding__text {
+  display: -webkit-box;
+  max-width: 100%;
+  -webkit-line-clamp: 4;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+  line-height: 20px;
+  color: $palette-cyan-700;
+}

enterprise/web-frontend/modules/baserow_enterprise/components/assistant/AssistantOnboardingMessage.vue

@@ -0,0 +1,50 @@
+<template>
+  <div class="assistant-onboarding">
+    <div class="assistant-onboarding__logo">
+      <img :src="image" alt="kuma" width="56" height="56" />
+    </div>
+    <div class="assistant-onboarding__title">
+      <i class="iconoir-magic-wand assistant-onboarding__title-icon"></i>
+      Kuma is building your database
+    </div>
+    <div class="assistant-onboarding__message">
+      <div class="assistant-onboarding__loading-wrapper">
+        <div class="assistant-onboarding__loading"></div>
+      </div>
+      <div class="assistant-onboarding__text">
+        {{ message }}
+      </div>
+    </div>
+  </div>
+</template>
+
+<script>
+import { mapGetters } from 'vuex'
+import image from '@baserow_enterprise/assets/images/kuma.svg?url'
+
+export default {
+  name: 'AssistantOnboardingMessage',
+  computed: {
+    ...mapGetters({
+      messages: 'assistant/messages',
+    }),
+    message() {
+      const defaultMessage = this.$t('assistantOnboardingMessage.instructing')
+      const messages = Array.isArray(this.messages) ? this.messages : []
+      const lastReasoning = [...messages]
+        .reverse()
+        .find(
+          (m) =>
+            m?.role === 'ai' &&
+            m?.reasoning === true &&
+            typeof m?.content === 'string' &&
+            m.content.trim()
+        )
+      return lastReasoning?.content ?? defaultMessage
+    },
+    image() {
+      return image
+    },
+  },
+}
+</script>

enterprise/web-frontend/modules/baserow_enterprise/components/assistant/AssistantSidebarItem.vue

@@ -41,7 +41,7 @@ export default {
       )
     },
     isConfigured() {
-      return this.$config.public.baserowEnterpriseAssistantLLMModel !== null
+      return !!this.$config.public.baserowEnterpriseAssistantLLMModel
     },
   },
   mounted() {