Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude/commands/review-commit.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Please review the **staged changes** (git diff --cached) in this repository agai

## Context

This is the **Databricks Apps Kit** (@databricks/app-kit) - a modular TypeScript SDK for building Databricks apps with workflows and plugins.
This is the **Databricks Apps Kit** (@databricks/appkit) - a modular TypeScript SDK for building Databricks apps with workflows and plugins.

## SDK Core Principles

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/review-pr.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Please review **all changes in the current branch** (compared to $ARGUMENTS or m

## Context

This is the **Databricks AppKit** (@databricks/app-kit) - a modular TypeScript SDK for building Databricks apps with workflows and plugins.
This is the **Databricks AppKit** (@databricks/appkit) - a modular TypeScript SDK for building Databricks apps with workflows and plugins.

## SDK Core Principles

Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ jobs:
name: Detect Changes
outputs:
docs: ${{ steps.filter.outputs.docs }}
app-kit: ${{ steps.filter.outputs.app-kit }}
appkit: ${{ steps.filter.outputs.appkit }}
steps:
- uses: actions/checkout@v4
- uses: dorny/paths-filter@v3
Expand All @@ -31,7 +31,7 @@ jobs:
filters: |
docs:
- 'docs/**'
app-kit:
appkit:
- '!docs/**'

lint_and_typecheck:
Expand Down Expand Up @@ -61,7 +61,7 @@ jobs:
test:
name: Unit Tests
needs: detect-changes
if: needs.detect-changes.outputs.app-kit == 'true'
if: needs.detect-changes.outputs.appkit == 'true'
runs-on:
group: databricks-protected-runner-group
labels: linux-ubuntu-latest
Expand Down
16 changes: 8 additions & 8 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ Databricks AppKit is a modular TypeScript SDK for building Databricks applicatio

```
/packages/
/app-kit/ - Core SDK with plugin architecture
/app-kit-ui/ - React components and JS utilities
/appkit/ - Core SDK with plugin architecture
/appkit-ui/ - React components and JS utilities
/shared/ - Shared TypeScript types across packages

/apps/
Expand Down Expand Up @@ -70,8 +70,8 @@ pnpm test:watch # Run tests in watch mode
```

**Test Projects:**
- `app-kit-ui`: Uses jsdom environment (for React components)
- `app-kit`: Uses node environment (for Node.js SDK)
- `appkit-ui`: Uses jsdom environment (for React components)
- `appkit`: Uses node environment (for Node.js SDK)

### Code Quality
```bash
Expand Down Expand Up @@ -113,7 +113,7 @@ AppKit uses a **phase-based plugin architecture** with three initialization phas

**Creating a Plugin:**
```typescript
import { Plugin, toPlugin } from '@databricks/app-kit';
import { Plugin, toPlugin } from '@databricks/appkit';

class MyPlugin extends Plugin {
name: string = "my-plugin";
Expand Down Expand Up @@ -257,7 +257,7 @@ Biome is used instead of ESLint/Prettier for faster performance:
pnpm add -Dw <package>

# Package-specific dependencies
pnpm --filter=@databricks/app-kit add <package>
pnpm --filter=@databricks/appkit add <package>

# App dependencies
pnpm --filter=sdk-playground add <package>
Expand All @@ -273,7 +273,7 @@ Packages should:

### Type Generation

`packages/app-kit/src/utils/type-generator.ts` creates plugin registry types at build time. This enables:
`packages/appkit/src/utils/type-generator.ts` creates plugin registry types at build time. This enables:
```typescript
const AppKit = await createApp({ plugins: [...] });
AppKit.myPlugin.method(); // Typed based on registered plugins
Expand All @@ -291,7 +291,7 @@ The reference app demonstrates AppKit usage:
**Frontend (`apps/dev-playground/client/`):**
- Vite + React 19 + TypeScript
- TanStack Router for file-based routing (routes in `src/routes/`)
- Components from `@databricks/app-kit-ui`
- Components from `@databricks/appkit-ui`
- Route files: `src/routes/<page-name>.route.tsx`
- Root layout: `src/routes/__root.tsx`

Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# App Kit
# AppKit

> [!WARNING]
> ## ⚠️ PREVIEW - NOT FOR PRODUCTION USE
Expand All @@ -17,7 +17,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and contribution gu

## Documentation

The `docs/` directory contains the App Kit documentation site, built with Docusaurus.
The `docs/` directory contains the AppKit documentation site, built with Docusaurus.

**Working with docs:**

Expand Down
2 changes: 1 addition & 1 deletion apps/clean-app/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
"preview": "vite preview"
},
"dependencies": {
"@databricks/app-kit": "workspace:*",
"@databricks/appkit": "workspace:*",
"react": "^19.2.0",
"react-dom": "^19.2.0"
},
Expand Down
2 changes: 1 addition & 1 deletion apps/clean-app/server.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
import { createApp, server } from "@databricks/app-kit";
import { createApp, server } from "@databricks/appkit";

createApp({
plugins: [server()],
Expand Down
2 changes: 1 addition & 1 deletion apps/dev-playground/client/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
<div id="root"></div>
<script>
(function() {
const THEME_STORAGE_KEY = "app-kit-playground-theme";
const THEME_STORAGE_KEY = "appkit-playground-theme";
const storedTheme = localStorage.getItem(THEME_STORAGE_KEY);
const root = document.documentElement;

Expand Down
8 changes: 4 additions & 4 deletions apps/dev-playground/client/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 3 additions & 3 deletions apps/dev-playground/client/src/appKitTypes.d.ts
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
// Auto-generated by AppKit - DO NOT EDIT
// Generated by 'npx appkit-generate-types' or Vite plugin during build
import "@databricks/app-kit-ui/react";
import type { SQLTypeMarker, SQLStringMarker, SQLNumberMarker, SQLBooleanMarker, SQLBinaryMarker, SQLDateMarker, SQLTimestampMarker } from "@databricks/app-kit-ui/js";
import "@databricks/appkit-ui/react";
import type { SQLTypeMarker, SQLStringMarker, SQLNumberMarker, SQLBooleanMarker, SQLBinaryMarker, SQLDateMarker, SQLTimestampMarker } from "@databricks/appkit-ui/js";

declare module "@databricks/app-kit-ui/react" {
declare module "@databricks/appkit-ui/react" {
interface QueryRegistry {
app_activity_heatmap: {
name: "app_activity_heatmap";
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ import {
SelectItem,
SelectTrigger,
SelectValue,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";

interface FilterBarProps {
filters: DashboardFilters;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import {
CardHeader,
CardTitle,
Skeleton,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";
import type { Aggregation, DashboardFilters } from "@/lib/types";

interface SummaryCardsProps {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import {
SelectItem,
SelectTrigger,
SelectValue,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";

interface TopContributorsChartProps {
groupBy: "app" | "user";
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ import {
CardDescription,
CardHeader,
CardTitle,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";

interface UntaggedApp {
id: string;
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import { sql } from "@databricks/app-kit-ui/js";
import { BarChart } from "@databricks/app-kit-ui/react";
import { sql } from "@databricks/appkit-ui/js";
import { BarChart } from "@databricks/appkit-ui/react";
import {
Card,
CardContent,
Expand All @@ -10,7 +10,7 @@ import {
SelectItem,
SelectTrigger,
SelectValue,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";

interface UsageTrendsChartProps {
groupBy: "default" | "app" | "user";
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import {
TableHead,
TableHeader,
TableRow,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";
import {
type ColumnDef,
type ColumnFiltersState,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ import {
CardContent,
CardHeader,
CardTitle,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";

export function ErrorComponent({ error }: { error: ErrorComponentProps }) {
return (
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import {
Tooltip,
TooltipContent,
TooltipTrigger,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";

export function Header({
title,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ import {
Tooltip,
TooltipContent,
TooltipTrigger,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";
import { InfoIcon } from "lucide-react";
import { Timeline } from "./timeline";
import { getStatusBadgeStyle } from "./utils";
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
import { Badge, Card } from "@databricks/app-kit-ui/react";
import { Badge, Card } from "@databricks/appkit-ui/react";

interface Message {
count: number;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import {
Tooltip,
TooltipContent,
TooltipTrigger,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";

export function PageHeader() {
return (
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
import { Card } from "@databricks/app-kit-ui/react";
import { Card } from "@databricks/appkit-ui/react";

export function TestPlan() {
return (
Expand Down
6 changes: 3 additions & 3 deletions apps/dev-playground/client/src/components/theme-selector.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ import {
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuTrigger,
} from "@databricks/app-kit-ui/react";
import { Button } from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";
import { Button } from "@databricks/appkit-ui/react";

type Theme = "light" | "dark" | "system";

const THEME_STORAGE_KEY = "app-kit-playground-theme";
const THEME_STORAGE_KEY = "appkit-playground-theme";

function getSystemTheme(): "light" | "dark" {
if (typeof window === "undefined") return "light";
Expand Down
2 changes: 1 addition & 1 deletion apps/dev-playground/client/src/index.css
Original file line number Diff line number Diff line change
@@ -1 +1 @@
@import "@databricks/app-kit-ui/styles.css";
@import "@databricks/appkit-ui/styles.css";
2 changes: 1 addition & 1 deletion apps/dev-playground/client/src/lib/utils/filter-utils.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
import { sql } from "@databricks/app-kit-ui/js";
import { sql } from "@databricks/appkit-ui/js";
import type { Aggregation, DashboardFilters } from "@/lib/types";

const ALLOWED_PERIODS = ["day", "week", "month"] as const;
Expand Down
4 changes: 2 additions & 2 deletions apps/dev-playground/client/src/routes/__root.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ import {
useLocation,
} from "@tanstack/react-router";
import { ErrorComponent } from "@/components/error-component";
import { Button, TooltipProvider } from "@databricks/app-kit-ui/react";
import { Button, TooltipProvider } from "@databricks/appkit-ui/react";
import { ThemeSelector } from "@/components/theme-selector";

export const Route = createRootRoute({
Expand All @@ -28,7 +28,7 @@ function RootComponent() {
className="no-underline text-inherit hover:opacity-80 transition-opacity"
>
<h4 className="text-xl font-semibold tracking-tight text-foreground">
App Kit Playground
AppKit Playground
</h4>
</Link>
<div className="flex items-center gap-3">
Expand Down
2 changes: 1 addition & 1 deletion apps/dev-playground/client/src/routes/analytics.route.tsx
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
import { useAnalyticsQuery } from "@databricks/app-kit-ui/react";
import { useAnalyticsQuery } from "@databricks/appkit-ui/react";
import { createFileRoute, retainSearchParams } from "@tanstack/react-router";
import { useMemo, useState } from "react";
import {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import { AnalyticsHeader } from "@/components/analytics";
import { sql } from "@databricks/app-kit-ui/js";
import { sql } from "@databricks/appkit-ui/js";
import {
AreaChart,
BarChart,
Expand All @@ -12,7 +12,7 @@ import {
HeatmapChart,
LineChart,
PieChart,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";
import { createFileRoute, retainSearchParams } from "@tanstack/react-router";

export const Route = createFileRoute("/arrow-analytics")({
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import { Header } from "@/components/layout/header";
import { sql } from "@databricks/app-kit-ui/js";
import { sql } from "@databricks/appkit-ui/js";
import {
AreaChart,
BarChart,
Expand All @@ -13,7 +13,7 @@ import {
LineChart,
PieChart,
RadarChart,
} from "@databricks/app-kit-ui/react";
} from "@databricks/appkit-ui/react";
import { createFileRoute } from "@tanstack/react-router";
import { useEffect, useState } from "react";
import { codeToHtml } from "shiki";
Expand Down Expand Up @@ -78,7 +78,7 @@ function DataVisualizationRoute() {
<div className="max-w-[1200px] mx-auto px-6 py-12">
<Header
title="Data Visualization"
description="Explore powerful and customizable chart components from the App Kit."
description="Explore powerful and customizable chart components from the AppKit."
tooltip="Showcase of BarChart, AreaChart, LineChart, PieChart, and RadarChart components"
/>

Expand Down
Loading