KTL-4149 feat: add TeamCity project for building landing pages

Author: nikpachoo

.teamcity/common/utils.kt

@@ -0,0 +1,8 @@
+package common
+
+/**
+ * Sanitizes a string to be used as a TeamCity ID.
+ *
+ * @param id The string to sanitize
+ */
+fun sanitizeId(id: String): String = id.replace("[^a-zA-Z0-9_]".toRegex(), "_")

.teamcity/landings/LandingConfiguration.kt

@@ -0,0 +1,26 @@
+package landings
+
+/**
+ * Configuration for a landing page instance.
+ * Each landing page is a separate client app.
+ *
+ * @param name The landing page name, used as base path
+ * @param repositoryUrl The GitHub repository URL
+ * @param branch The branch to build from
+ */
+data class LandingConfiguration(
+  val name: String,
+  val repositoryUrl: String,
+  val branch: String = "main"
+)
+
+/**
+ * List of all landing pages to be built.
+ * Add new landing pages here.
+ */
+val landingConfigurations = listOf(
+  LandingConfiguration(
+    name = "kotlin-spring-ai-tutorial",
+    repositoryUrl = "git@github.com:jetbrains-lovable/kotlin-ai-tutorial.git"
+  )
+)

.teamcity/landings/LandingPagesProject.kt

@@ -0,0 +1,16 @@
+package landings
+
+import jetbrains.buildServer.configs.kotlin.Project
+import landings.builds.BuildLandingPage
+
+object LandingPagesProject : Project({
+  name = "Landing Pages"
+  description = "Builds landing pages from repositories"
+
+  landingConfigurations.forEach { config ->
+    vcsRoot(createVcsRootForLanding(config))
+
+    buildType(BuildLandingPage(config))
+  }
+})
+

.teamcity/landings/builds/BuildLandingPage.kt

@@ -0,0 +1,70 @@
+package landings.builds
+
+import BuildParams.KLANG_NODE_CONTAINER
+import jetbrains.buildServer.configs.kotlin.BuildType
+import jetbrains.buildServer.configs.kotlin.buildSteps.script
+import jetbrains.buildServer.configs.kotlin.triggers.vcs
+import landings.LandingConfiguration
+import common.sanitizeId
+import landings.createVcsRootForLanding
+
+/**
+ * Build type for building a Vite landing page.
+ * This build:
+ * 1. Checks out the landing page repository
+ * 2. Patches the Vite config to set the correct base path
+ * 3. Installs npm dependencies
+ * 4. Builds the static page
+ * 5. Publishes the dist folder as an artifact
+ */
+class BuildLandingPage(private val config: LandingConfiguration) : BuildType({
+  id("build_landing_${sanitizeId(config.name)}")
+  name = "Build ${config.name} langing page"
+
+  vcs {
+    root(createVcsRootForLanding(config))
+    root(vcsRoots.KotlinLangOrg, "+:scripts => kotlin-web-site-scripts")
+    cleanCheckout = true
+  }
+
+  triggers {
+    vcs {
+      branchFilter = "+:${config.branch}"
+    }
+  }
+
+  artifactRules = """
+    dist/** => ${config.name}.zip
+  """.trimIndent()
+
+  requirements {
+    contains("docker.server.osType", "linux")
+  }
+
+  steps {
+    script {
+      name = "Patch Vite config and build"
+      scriptContent = """
+        #!/bin/sh
+        set -e -x -u
+
+        # Patch Vite config
+        node kotlin-web-site-scripts/patch-vite-base.mjs ${config.name}
+
+        # Install dependencies
+        npm ci
+
+        # Build
+        npm run build
+
+        # Verify dist folder exists
+        if [ ! -d "dist" ]; then
+          echo "Error: dist folder not found after build"
+          exit 1
+        fi
+      """.trimIndent()
+      dockerImage = KLANG_NODE_CONTAINER
+      dockerPull = true
+    }
+  }
+})

.teamcity/landings/createVcsRootForLanding.kt

@@ -0,0 +1,16 @@
+package landings
+
+import common.sanitizeId
+import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
+
+fun createVcsRootForLanding(config: LandingConfiguration): GitVcsRoot {
+  return GitVcsRoot {
+      id("landing_vcs_${sanitizeId(config.name)}")
+      name = "Landing: ${config.name}"
+      url = config.repositoryUrl
+      authMethod = uploadedKey {
+          uploadedKey = "default teamcity key"
+      }
+      branch = "refs/heads/${config.branch}"
+  }
+}

.teamcity/settings.kts

@@ -31,6 +31,7 @@ project {
     references.BuildApiReferencesProject,
     tests.TestsProject,
     documentation.DocumentationProject,
+    landings.LandingPagesProject,
   ).also {
     it.forEach { subProject(it) }
   }

scripts/patch-vite-base.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+/**
+ * Patches Vite config to add the correct base path for deployment.
+ */
+
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+
+const landingName = process.argv[2];
+
+if (!landingName) {
+  console.error('Error: Landing name is required');
+  process.exit(1);
+}
+
+const configFiles = ['vite.config.ts', 'vite.config.js', 'vite.config.mjs'];
+let viteConfigPath = null;
+
+for (const configFile of configFiles) {
+  if (existsSync(configFile)) {
+    viteConfigPath = resolve(configFile);
+    break;
+  }
+}
+
+if (!viteConfigPath) {
+  console.error('Error: No vite config file found (checked: vite.config.ts, vite.config.js, vite.config.mjs)');
+  process.exit(1);
+}
+
+console.log(`Found Vite config: ${viteConfigPath}`);
+
+let content = readFileSync(viteConfigPath, 'utf-8');
+
+const basePath = `/lp/${landingName}/`;
+
+if (content.includes('base:')) {
+  console.log('Base path already exists, replacing...');
+  content = content.replace(
+    /base\s*:\s*['"`][^'"`]*['"`]/g,
+    `base: '${basePath}'`
+  );
+} else {
+  console.log('Adding base path to config...');
+  content = content.replace(
+    /defineConfig\s*\(\s*\{/,
+    `defineConfig({\n  base: '${basePath}',`
+  );
+}
+
+writeFileSync(viteConfigPath, content, 'utf-8');
+
+console.log(`Successfully patched ${viteConfigPath} with base: '${basePath}'`);
+