@databricks-solutions/lakebase-scm-utils 0.2.51 → 0.3.1

package/scripts/lakebase/schema-migrate.ts

@@ -30,6 +30,9 @@ import { normalizeTierName, protectedTierNamesFromEnv } from "./branch-utils.js"
 import "./adapters/alembic-adapter.js";
 import "./adapters/flyway-adapter.js";
 import "./adapters/knex-adapter.js";
+import "./adapters/efcore-adapter.js";
+import { isDotnetFlywayProject, flywayMigrationsDir } from "./dotnet-project.js";
+import { listEfCoreFiles } from "./adapters/efcore-adapter.js";
 import {
   resolveSchemaMigrationAdapter,
   type SchemaMigrationAdapterId,
@@ -38,9 +41,9 @@ import {
   type CollapseHeadsResult,
 } from "./schema-migration-adapter.js";
 
-export type SchemaMigrationLanguage = "java" | "kotlin" | "python" | "nodejs";
+export type SchemaMigrationLanguage = "java" | "kotlin" | "python" | "nodejs" | "dotnet";
 
-export type SchemaMigrationToolName = "flyway" | "alembic" | "knex";
+export type SchemaMigrationToolName = "flyway" | "alembic" | "knex" | "efcore";
 
 export interface SchemaMigrationFile {
   /** Stable identifier sortable in apply-order: Flyway `V<n>`, Alembic
@@ -48,7 +51,7 @@ export interface SchemaMigrationFile {
   version: string;
   filename: string;
   description: string;
-  type: "SQL" | "Python" | "JavaScript" | "TypeScript";
+  type: "SQL" | "Python" | "JavaScript" | "TypeScript" | "CSharp";
   /** Tool that should run this file. */
   tool: SchemaMigrationToolName;
 }
@@ -149,16 +152,24 @@ export function detectLanguage(projectDir: string): SchemaMigrationLanguage {
   if (lang === "unknown") {
     throw new SchemaMigrationError(
       `Could not detect project language in ${projectDir}. ` +
-        `Expected one of: pom.xml (java/kotlin), pyproject.toml or alembic.ini (python), package.json (nodejs). ` +
+        `Expected one of: pom.xml (java/kotlin), pyproject.toml or alembic.ini (python), package.json (nodejs), *.sln or *.csproj (dotnet). ` +
         `Pass {language} explicitly to override.`
     );
   }
   return lang;
 }
 
-/** Map a language to the migration tool the kit invokes for it. */
-export function toolForLanguage(language: SchemaMigrationLanguage): SchemaMigrationToolName {
+/**
+ * Map a language to the migration tool the kit invokes for it. .NET supports
+ * two tools, so it also needs the project directory: EF Core when a project
+ * references Microsoft.EntityFrameworkCore.Design, Flyway when SQL migrations
+ * live in db/migrations/ (Flyway wins when both are present), else EF Core.
+ */
+export function toolForLanguage(language: SchemaMigrationLanguage, projectDir?: string): SchemaMigrationToolName {
   switch (language) {
+    case "dotnet":
+      if (projectDir && isDotnetFlywayProject(projectDir)) return "flyway";
+      return "efcore";
     case "java":
     case "kotlin":
       return "flyway";
@@ -182,9 +193,11 @@ export function toolForLanguage(language: SchemaMigrationLanguage): SchemaMigrat
 export function listSchemaMigrations(args: ListSchemaMigrationsArgs = {}): SchemaMigrationFile[] {
   const projectDir = args.projectDir ?? process.cwd();
   const language = args.language ?? detectLanguage(projectDir);
-  const tool = toolForLanguage(language);
+  const tool = toolForLanguage(language, projectDir);
 
   switch (tool) {
+    case "efcore":
+      return listEfCoreFiles(projectDir);
     case "flyway":
       return listFlywayMigrations(projectDir);
     case "alembic":
@@ -195,8 +208,9 @@ export function listSchemaMigrations(args: ListSchemaMigrationsArgs = {}): Schem
 }
 
 function listFlywayMigrations(projectDir: string): SchemaMigrationFile[] {
-  // Flyway convention: src/main/resources/db/migration/V<n>__<desc>.sql
-  const dir = path.join(projectDir, "src", "main", "resources", "db", "migration");
+  // Flyway convention: V<n>__<desc>.sql under the Maven layout (Java/Kotlin)
+  // or db/migrations/ (.NET); see flywayMigrationsDir.
+  const dir = flywayMigrationsDir(projectDir);
   if (!fs.existsSync(dir)) return [];
   const files = fs.readdirSync(dir).filter((f) => /^V\d+(\.\d+)*__.+\.sql$/.test(f));
   return files
@@ -291,7 +305,7 @@ async function dsnFor(args: {
 /** Resolve an adapter, honoring an explicit language override. */
 function adapterFor(projectDir: string, language?: SchemaMigrationLanguage) {
   const override: SchemaMigrationAdapterId | undefined = language
-    ? toolForLanguage(language)
+    ? toolForLanguage(language, projectDir)
     : undefined;
   return resolveSchemaMigrationAdapter(projectDir, override);
 }

package/templates/project/common/.github/workflows/merge.yml

@@ -143,6 +143,18 @@ jobs:
           fi
           npm install
 
+      - name: Set up .NET
+        if: steps.detect-lang.outputs.lang == 'dotnet'
+        uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+      - name: Restore .NET packages and tools
+        if: steps.detect-lang.outputs.lang == 'dotnet'
+        run: |
+          dotnet restore
+          if [ -f .config/dotnet-tools.json ]; then dotnet tool restore; fi
+
       # The official action installs to a user-writable path (no sudo). It's
       # a no-op if a compatible databricks CLI is already on PATH.
       - name: Install Databricks CLI
@@ -218,7 +230,7 @@ jobs:
       #   3. Default https://repo1.maven.org/maven2 for GitHub-hosted
       #      runners with public internet.
       - name: Install Flyway CLI
-        if: hashFiles('pom.xml') != ''
+        if: (hashFiles('pom.xml') != '' || hashFiles('db/migrations/**') != '')
         env:
           FLYWAY_DOWNLOAD_BASE_URL: ${{ vars.FLYWAY_DOWNLOAD_BASE_URL }}
         run: |

package/templates/project/common/.github/workflows/pr.yml

@@ -102,6 +102,18 @@ jobs:
           fi
           npm install
 
+      - name: Set up .NET
+        if: steps.detect-lang.outputs.lang == 'dotnet'
+        uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+      - name: Restore .NET packages and tools
+        if: steps.detect-lang.outputs.lang == 'dotnet'
+        run: |
+          dotnet restore
+          if [ -f .config/dotnet-tools.json ]; then dotnet tool restore; fi
+
       # Install frontend dependencies when a `client/` workspace is present
       # (Python+React layouts etc.). Gated on client/package.json so projects
       # without a frontend skip this transparently.
@@ -301,10 +313,12 @@ jobs:
           BODY="⚠️ **No Lakebase CI branch** was created. This run is not using a dedicated database branch. Open the [workflow run](${RUN_URL}), expand **Create CI database branch (Lakebase)** and check the step **Summary** (or log) for the reason and how to fix it."
           gh pr comment "$PR" --body "$BODY" 2>/dev/null || true
 
-      # Install Flyway CLI for Java/Kotlin projects only. The substrate's
-      # migrate runner spawns the standalone `flyway` binary; non-Java
-      # projects don't need it. Runtime-gated on pom.xml so the YAML is
-      # one shape for every language.
+      # Install Flyway CLI for Java/Kotlin projects and .NET projects that use
+      # Flyway (db/migrations/). The substrate's migrate runner spawns the
+      # standalone `flyway` binary; other projects don't need it. Runtime-gated
+      # on pom.xml / any file under db/migrations/ (what the adapter checks; a
+      # fresh scaffold has only its README there) so the YAML is one shape for
+      # every language.
       #
       # Resolution order:
       #   1. `flyway` already on PATH (self-hosted runner with brew /
@@ -315,7 +329,7 @@ jobs:
       #   3. Default https://repo1.maven.org/maven2 for GitHub-hosted
       #      runners with public internet.
       - name: Install Flyway CLI
-        if: steps.lakebase-db.outputs.url != '' && hashFiles('pom.xml') != ''
+        if: steps.lakebase-db.outputs.url != '' && (hashFiles('pom.xml') != '' || hashFiles('db/migrations/**') != '')
         env:
           FLYWAY_DOWNLOAD_BASE_URL: ${{ vars.FLYWAY_DOWNLOAD_BASE_URL }}
         run: |
@@ -388,6 +402,8 @@ jobs:
               uv run pytest
             elif [ "$LANG" = "nodejs" ]; then
               npm test
+            elif [ "$LANG" = "dotnet" ]; then
+              dotnet test --no-restore
             fi
           else
             echo "::error::No CI branch URL – cannot run tests without a database. Check the 'Create CI database branch' step for details."
@@ -570,6 +586,10 @@ jobs:
               desc=$(echo "$base" | sed 's/^[^_]*_//' | sed 's/\.py$//' | tr '_' ' ')
               [ -n "$rev" ] && echo "| $rev | $desc |" >> "$MD"
             done
+          elif [ "$LANG" = "dotnet" ]; then
+            # EF Core or Flyway: the kit's canonical discovery picks the tool + files.
+            npx --yes --package="${SCM_UTILS_NPX_PKG}" lakebase-schema-migrate list \
+              | jq -r '.[] | if .tool == "flyway" then "| V\(.version) | \(.description) |" else "| \(.version) | \(.description) (EF Core) |" end' >> "$MD"
           elif [ "$LANG" = "nodejs" ]; then
             for f in migrations/*.js; do
               [ -f "$f" ] || continue

package/templates/project/common/scripts/flyway-migrate.sh

@@ -66,10 +66,63 @@ elif [ -f "$REPO_ROOT/requirements.txt" ] || [ -f "$REPO_ROOT/pyproject.toml" ];
     source .venv/bin/activate
   fi
   alembic upgrade head "$@"
+elif [ -n "$(find "$REPO_ROOT" -maxdepth 1 \( -name '*.sln' -o -name '*.slnx' -o -name '*.csproj' \) -print -quit 2>/dev/null)" ]; then
+  # .NET: EF Core or Flyway (db/migrations/).
+  if [ -n "${DATABASE_URL:-}" ]; then
+    # Explicit target (CI secret, ephemeral-verify DSN): run the tool directly.
+    if [ -d "$REPO_ROOT/db/migrations" ]; then
+      _np="${DATABASE_URL#postgresql://}"; _cr="${_np%%@*}"; _hp="${_np#*@}"
+      # Decode %XX only ('+' is literal in URL userinfo, and backslashes in a
+      # credential must not be interpreted as escapes).
+      _urldecode() {
+        local s="$1" out="" c
+        while [ -n "$s" ]; do
+          c="${s:0:1}"; s="${s:1}"
+          if [ "$c" = "%" ] && [ "${#s}" -ge 2 ]; then
+            out+="$(printf "\\x${s:0:2}")"; s="${s:2}"
+          else
+            out+="$c"
+          fi
+        done
+        printf '%s' "$out"
+      }
+      FLYWAY_URL="jdbc:postgresql://${_hp}" \
+      FLYWAY_USER="$(_urldecode "${_cr%%:*}")" \
+      FLYWAY_PASSWORD="$(_urldecode "${_cr#*:}")" \
+        flyway "-locations=filesystem:$REPO_ROOT/db/migrations" \
+          -baselineOnMigrate=true -baselineVersion=0 migrate "$@"
+    else
+      # Relative to the repo root (the cwd here): an absolute path through a
+      # symlinked directory (e.g. macOS /tmp -> /private/tmp) makes MSBuild see
+      # two different project paths and dotnet ef then loses the build output.
+      _csproj="$(grep -l "Microsoft.EntityFrameworkCore.Design" \
+        $(find . -maxdepth 3 -name '*.csproj' -not -path '*/tests/*' -not -path '*/test/*' \
+            -not -path '*/client/*' -not -path '*/bin/*' -not -path '*/obj/*' -not -path '*/node_modules/*' | sort) \
+        2>/dev/null | head -1)"
+      [ -n "$_csproj" ] || { echo "No *.csproj references Microsoft.EntityFrameworkCore.Design." >&2; exit 1; }
+      # dotnet ef reads project metadata before it builds, so restore first
+      # (a fresh clone or a cleaned obj/ has no assets file).
+      if [ -f .config/dotnet-tools.json ]; then dotnet tool restore >/dev/null; fi
+      dotnet restore "$_csproj" >/dev/null
+      # The design-time DbContext factory reads DATABASE_URL, so no password
+      # is passed on the command line.
+      dotnet ef database update --project "$_csproj" "$@"
+    fi
+  else
+    # Paired branch from .env metadata: the kit's tool-agnostic migrate CLI
+    # picks the tool, mints a fresh credential, and refuses protected tiers,
+    # exactly as CI does.
+    if [ ! -x "$SCRIPT_DIR/lk" ] || [ -z "${LAKEBASE_PROJECT_ID:-}" ] || [ -z "${LAKEBASE_BRANCH_ID:-}" ]; then
+      echo "Cannot migrate: need scripts/lk plus LAKEBASE_PROJECT_ID and LAKEBASE_BRANCH_ID (written to .env by the post-checkout hook), or DATABASE_URL." >&2
+      exit 1
+    fi
+    "$SCRIPT_DIR/lk" lakebase-schema-migrate apply \
+      --instance "$LAKEBASE_PROJECT_ID" --branch "$LAKEBASE_BRANCH_ID" "$@"
+  fi
 elif [ -f "$REPO_ROOT/package.json" ]; then
   # Node.js / Knex
   npx knex migrate:latest "$@"
 else
-  echo "Could not detect project language. Expected pom.xml (Java), pyproject.toml/requirements.txt (Python), or package.json (Node.js)."
+  echo "Could not detect project language. Expected pom.xml (Java), pyproject.toml/requirements.txt (Python), *.sln/*.csproj (.NET), or package.json (Node.js)."
   exit 1
 fi

package/templates/project/common/scripts/prepare-schema-diff.sh

@@ -107,6 +107,11 @@ if [ -d src/main/resources/db/migration ]; then
     desc="$(echo "$base" | sed -n 's/^V[0-9.]*__\(.*\)\.sql$/\1/p' | tr '_' ' ')"
     [ -n "$ver" ] && echo "| V$ver | $desc |" >> "$MD"
   done
+elif [ -n "$(find . -maxdepth 1 \( -name '*.sln' -o -name '*.slnx' -o -name '*.csproj' \) -print -quit 2>/dev/null)" ] \
+    && [ -x "$WORK_TREE/scripts/lk" ]; then
+  # .NET (EF Core or Flyway): the kit's canonical discovery picks the tool + files.
+  "$WORK_TREE/scripts/lk" lakebase-schema-migrate list 2>/dev/null \
+    | jq -r '.[] | if .tool == "flyway" then "| V\(.version) | \(.description) |" else "| \(.version) | \(.description) (EF Core) |" end' >> "$MD" || true
 elif [ -d alembic/versions ]; then
   # Alembic / Python
   for f in alembic/versions/*.py; do

package/templates/project/common/scripts/run-dev.sh

@@ -209,6 +209,15 @@ for r in getattr(app, 'routes', []):
   fi
 
   uv run uvicorn app.main:app --reload --host "$HOST" --port "$PORT" "$@"
+elif [ -n "$(find "$REPO_ROOT" -maxdepth 1 \( -name '*.sln' -o -name '*.slnx' -o -name '*.csproj' \) -print -quit 2>/dev/null)" ]; then
+  # .NET / ASP.NET Core. The app reads .env itself and mints its own credential.
+  PORT="$(resolve_port 8000)"
+  export PORT HOST
+  # Relative paths (cwd is the repo root): see the symlink note in flyway-migrate.sh.
+  _app="$(find src -maxdepth 2 -name '*.csproj' 2>/dev/null | head -1)"
+  _app="${_app:-$(find . -maxdepth 1 -name '*.csproj' 2>/dev/null | head -1)}"
+  echo "Serving on http://${HOST}:${PORT}  (Ctrl-C to stop). Open it in your browser."
+  dotnet watch --project "$_app" run -- --urls "http://${HOST}:${PORT}" "$@"
 elif [ -f "$REPO_ROOT/package.json" ]; then
   # Node.js – prefer a "dev" script, fall back to "start".
   PORT="$(resolve_port 8000)"
@@ -220,6 +229,6 @@ elif [ -f "$REPO_ROOT/package.json" ]; then
     npm start -- "$@"
   fi
 else
-  echo "Could not detect project language. Expected pom.xml (Java), pyproject.toml/requirements.txt (Python), or package.json (Node.js)."
+  echo "Could not detect project language. Expected pom.xml (Java), pyproject.toml/requirements.txt (Python), *.sln/*.csproj (.NET), or package.json (Node.js)."
   exit 1
 fi

package/templates/project/common/scripts/run-tests.sh

@@ -140,13 +140,18 @@ elif [ -f "$REPO_ROOT/requirements.txt" ] || [ -f "$REPO_ROOT/pyproject.toml" ];
   else
     uv run --extra dev pytest "$@"
   fi
+elif [ -n "$(find "$REPO_ROOT" -maxdepth 1 \( -name '*.sln' -o -name '*.slnx' -o -name '*.csproj' \) -print -quit 2>/dev/null)" ]; then
+  # .NET / EF Core or Flyway + xUnit
+  echo "Running migrations..."
+  "$REPO_ROOT/scripts/flyway-migrate.sh"
+  dotnet test "$@"
 elif [ -f "$REPO_ROOT/package.json" ]; then
   # Node.js / Knex + Jest
   echo "Running Knex migrations..."
   npx knex migrate:latest
   npm test "$@"
 else
-  echo "Could not detect project language. Expected pom.xml (Java), pyproject.toml/requirements.txt (Python), or package.json (Node.js)."
+  echo "Could not detect project language. Expected pom.xml (Java), pyproject.toml/requirements.txt (Python), *.sln/*.csproj (.NET), or package.json (Node.js)."
   exit 1
 fi
 

package/templates/project/dotnet/.gitignore.extra

@@ -0,0 +1,8 @@
+# .NET
+bin/
+obj/
+*.user
+*.suo
+.vs/
+TestResults/
+*.trx

package/templates/project/dotnet/App.sln

@@ -0,0 +1,56 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{827E0CD3-B72D-47B6-A68D-7590B98EB39B}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "App", "src\App\App.csproj", "{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{0AB3BF05-4346-4AA6-1389-037BE0695223}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "App.Tests", "tests\App.Tests\App.Tests.csproj", "{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Debug|x64 = Debug|x64
+		Debug|x86 = Debug|x86
+		Release|Any CPU = Release|Any CPU
+		Release|x64 = Release|x64
+		Release|x86 = Release|x86
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Debug|x64.Build.0 = Debug|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Debug|x86.Build.0 = Debug|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Release|Any CPU.Build.0 = Release|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Release|x64.ActiveCfg = Release|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Release|x64.Build.0 = Release|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Release|x86.ActiveCfg = Release|Any CPU
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2}.Release|x86.Build.0 = Release|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Debug|x64.Build.0 = Debug|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Debug|x86.Build.0 = Debug|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Release|x64.ActiveCfg = Release|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Release|x64.Build.0 = Release|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Release|x86.ActiveCfg = Release|Any CPU
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E}.Release|x86.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{DCBDD7E2-BB16-483D-92E7-913AB5681AA2} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
+		{3E88FEDA-D8D3-4939-BD9C-CFDD1EEBBC1E} = {0AB3BF05-4346-4AA6-1389-037BE0695223}
+	EndGlobalSection
+EndGlobal

package/templates/project/dotnet/Makefile

@@ -0,0 +1,13 @@
+.PHONY: install test migrate run
+
+install:
+	dotnet restore App.sln
+
+test:
+	dotnet test App.sln
+
+migrate:
+	./scripts/flyway-migrate.sh
+
+run:
+	dotnet run --project src/App -- --urls "http://127.0.0.1:$${PORT:-8000}"

package/templates/project/dotnet/global.json

@@ -0,0 +1,6 @@
+{
+  "sdk": {
+    "version": "10.0.100",
+    "rollForward": "latestFeature"
+  }
+}

package/templates/project/dotnet/src/App/Data/AppDbContext.cs

@@ -0,0 +1,12 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace App.Data;
+
+/// <summary>
+/// Application DbContext. Add DbSet&lt;TEntity&gt; properties for your tables.
+/// Schema changes go through migrations (see the project README), never
+/// EnsureCreated().
+/// </summary>
+public class AppDbContext(DbContextOptions<AppDbContext> options) : DbContext(options)
+{
+}

package/templates/project/dotnet/src/App/Lakebase/DotEnv.cs

@@ -0,0 +1,48 @@
+namespace App.Lakebase;
+
+/// <summary>
+/// Minimal .env loader (KEY=VALUE lines, # comments, optional quotes). Never
+/// overwrites variables already set in the process environment.
+/// </summary>
+public static class DotEnv
+{
+    public static void LoadFromRepoRoot()
+    {
+        foreach (var start in new[] { Directory.GetCurrentDirectory(), AppContext.BaseDirectory })
+        {
+            for (var dir = new DirectoryInfo(start); dir is not null; dir = dir.Parent)
+            {
+                var candidate = Path.Combine(dir.FullName, ".env");
+                if (File.Exists(candidate))
+                {
+                    Load(candidate);
+                    return;
+                }
+            }
+        }
+    }
+
+    public static void Load(string path)
+    {
+        foreach (var raw in File.ReadAllLines(path))
+        {
+            var line = raw.Trim();
+            if (line.Length == 0 || line.StartsWith('#'))
+                continue;
+            if (line.StartsWith("export ", StringComparison.Ordinal))
+                line = line[7..].TrimStart();
+
+            var eq = line.IndexOf('=');
+            if (eq <= 0)
+                continue;
+
+            var key = line[..eq].Trim();
+            var value = line[(eq + 1)..].Trim();
+            if (value.Length >= 2 && (value[0] == '"' || value[0] == '\'') && value[^1] == value[0])
+                value = value[1..^1];
+
+            if (Environment.GetEnvironmentVariable(key) is null)
+                Environment.SetEnvironmentVariable(key, value);
+        }
+    }
+}