Loading pattern preview
BlocksTools & Utilities
XLSX → CSV export
XLSX → CSV export
Load Excel .xlsx or .xls workbooks in the browser with SheetJS, pick a sheet, preview rows, and download CSV—with optional UTF-8 BOM and multi-sheet export.
Use this when your app takes existing Excel workbooks as input and must hand back CSV files, such as for data migration prep or offline conversion.
Loading pattern preview
Problems solved
Technical challenges this implementation handles out of the box.
- Convert uploaded Excel sheets to CSV without a server round trip
- Preview workbook rows and export one or all sheets
- Optionally add a UTF-8 BOM for Excel-friendly CSV
Use cases
Products and workflows this pattern is designed to support.
- Spreadsheet interchange tools
- Reporting export utilities
- Offline Excel to CSV conversion
- Data migration prep workflows
Compare with
Similar patterns, and when each one is the better fit.
Agent XLSX ArtifactUse this when your chat agent needs to hand users a downloadable .xlsx file, previewing the tabular data it streams as CSV before export.
CSV / TSV ↔ JSON tabular exportUse this when you need to turn pasted delimited text or JSON rows into a Markdown table or other text format without a server or AI model.
Spreadsheet AgentUse this when users need a multi-sheet .xlsx with cleaned data, a chart, a summary, and a log of every transform the agent applied.
CSV Editor ArtifactUse this when your chat app needs a spreadsheet artifact that auto-detects column types and is backed by Upstash storage.
Setup
Requirements, wiring steps, and what this pattern adds to your project.
Getting started
Pick how you want to pull this pattern in. Then wire env vars and routes the same way.
- 1
Download → Next.js app
Use Download → Next.js app in the preview toolbar. You get a zip scaffold (Pro downloads rewrite preview `/view/.../api/*` paths to `/api/*` automatically).
- 2
Extract the zip and install dependencies
Unzip the archive, then run `pnpm install` (or npm / yarn) in the project folder.
- 3
Customize the agent and tool files
Adapt prompts, tools, and stop conditions in the generated project for your product.
- 4
Run the app and open the pattern route
Run `pnpm dev`, open the setup/checklist page if present, then navigate to the generated pattern route and verify responses.
Files added
3 files
app/page.tsxapp/layout.tsxREADME.md
Dependencies
15 total
npm packages
8@hugeicons-pro/core-stroke-rounded@hugeicons/reactfile-saverNext.jsReactsonnerxlsxlucide-react
Registry components
buttoncardcheckboxemptylabelselecttable
Critical files
1 file
lib/xlsx-csv.tsSheetJS read from ArrayBuffer; sheet_to_csv for downloads; sheet_to_json header:1 for preview rows; sanitize filenames; UTF-8 BOM option; file-saver downloads.
Requirements
- Complexity
- Beginner
- Setup time
- ~5 minutes
