Add comprehensive UX contract header documenting: - @UX_STATE: all states of the page-level state machine (idle, loading, configured, saving, validation_error, datasource_unavailable, error) - @UX_STEP: 5 logically separated steps/tabs (Config, Preview, Target, Run, Schedule) - @UX_FEEDBACK: toasts, modals, inline progress, schema validation - @UX_RECOVERY: retry paths for save/preview/run failures - @UX_REACTIVITY: props, local state, derived, effects, store bindings - @UX_DEPENDENCY: data flow between datasource selection, env switching, config validity, and tab availability - @UX_TEST: test scenarios for the automated Judge Agent Also remove leftover sourceDialect/targetDialect selects from UI (now sent as sensible defaults in save payload). Sub-components (TargetSchemaHint, TranslationPreview, TranslationRunProgress, ScheduleConfig, BulkReplaceModal) already have UX contracts.
Superset Tools Frontend (SvelteKit)
This is the frontend for the Superset Tools application, built with SvelteKit in SPA mode.
Development
-
Install dependencies:
npm install -
Run development server:
npm run devThe frontend will be available at
http://localhost:5173. It is configured to proxy API requests tohttp://localhost:8000.
Production Build
-
Build the static SPA:
npm run buildThis generates a static SPA in the
build/directory. -
Serve with Backend: The Python backend is configured to serve the files from
frontend/build/. Ensure the backend is running:cd ../backend python src/app.py
Architecture
- Routing: File-based routing in
src/routes/. - Layouts: Shared UI in
src/routes/+layout.svelte. - Data Loading:
loadfunctions in+page.tsfor efficient data fetching. - API Client: Centralized API logic in
src/lib/api.js. - Styling: Tailwind CSS.