# Enterprise getting started: a complete example One page, one file, from an empty folder to a working grid with Excel, PDF and CSV export. Nothing is elided - every command and every line below was run end to end against the published packages. If you already have a project, skip to [step 2](#2-install). ## 1. Create a project ```bash npx sv create svgrid-trial --template minimal --types ts --no-add-ons cd svgrid-trial ``` Those flags skip every interactive prompt, so the sequence is copy-pasteable. For a plain Vite app instead, `npm create @svgrid@latest` scaffolds one with the grid already wired in - the component below drops into either. ## 2. Install ```bash npm install @svgrid/grid @svgrid/enterprise npm install jszip pdfmake # optional peers, for Excel and PDF export ``` `jszip` and `pdfmake` are optional peer dependencies, lazy-loaded the first time you actually call an export. Skip them if you only need CSV, TSV or HTML; `exportData` throws a message naming the missing package if you call a format whose peer is absent. **No build configuration is required.** If you are on `@svgrid/enterprise` 2.5.x or earlier, see [older versions](#older-versions) below - those releases shipped TypeScript source and needed two `optimizeDeps` entries in `vite.config.js`. ## 3. The component Replace the contents of `src/routes/+page.svelte` (or `src/App.svelte` in a Vite project) with this. It is self-contained: licence, theme, grid and exports, with nothing else to wire up. ```svelte

SvGrid Enterprise

Sort, filter, select, and double-click a cell to edit.

(api = installEnterprise(next))} />
{#if status}{status}{/if}

Export respects the current sort, filter and grouping. Change the theme import at the top of this file to re-skin the grid and this page together.

``` ## 4. Run it ```bash npm run dev ``` Open . You should get a five-row grid: click a header to sort, use the funnel for Excel-style filtering, double-click a cell to edit, and the four buttons write real files. ## What the three pieces do | Line | Why it's there | | --- | --- | | `setLicenseKey(...)` | Runs once, before any Enterprise call. Without it the pack still works, but watermarks and nudges the app. See [licensing](https://svgrid.com/docs/enterprise/licensing/). | | `installEnterprise(next)` | Wraps the `SvGridApi` from `onApiReady` and returns it with `exportData`, `importData`, `print`, pivot and AI attached. The `` component itself stays Community. | | `import '@svgrid/grid/themes/shadcn.css'` | Optional. Declares the `--sg-*` tokens for one of 20 presets. Without it the grid still renders, using the built-in fallbacks. | ## Server-side rendering The component above is SSR-safe as written: `theme` starts at a literal, and every DOM and `localStorage` access sits inside `$effect`, which only runs in the browser. No `export const ssr = false` is needed. If you move DOM access to module scope or into component initialisation, it will run on the server and throw. Keep it in `$effect` or `onMount`. ## Older versions `@svgrid/enterprise` 2.5.x and earlier shipped TypeScript source rather than a built bundle. Vite's dependency pre-bundler cannot parse the `.svelte.ts` rune modules in it, so those versions need two entries in `vite.config.js`: ```js optimizeDeps: { // Without this the dev server fails to start: // RolldownError ... Unexpected token (on `import type`) exclude: ['@svgrid/grid', '@svgrid/enterprise'], // Excluding it also stops ITS imports being pre-bundled, and jszip and // pdfmake are CommonJS. Without this, xlsx and pdf export fail with // "JSZip is not a constructor" / "pdfMake.createPdf is not a function". include: ['jszip', 'pdfmake/build/pdfmake', 'pdfmake/build/vfs_fonts'], }, ``` 2.6.0 moved the package to a built `dist`, so neither entry is needed. Upgrading is the better fix. ## Next - [Evaluation](https://svgrid.com/docs/enterprise/evaluation/) - what shows without a key, and how to remove it. - [Licensing](https://svgrid.com/docs/enterprise/licensing/) - key formats, seats, renewals. - [Data export](https://svgrid.com/docs/help/export/) - styles, headers, images, multi-sheet. - [Data import](https://svgrid.com/docs/help/import/) - column mapping and per-row validation. --- SvGrid is the Svelte 5 data grid (`npm install @svgrid/grid`, MIT). This page: https://svgrid.com/docs/enterprise/getting-started/ . All docs: https://svgrid.com/llms.txt