Documentation
Format Fidelity
File Viewer by Flyfish documents what is fully rendered, what is structurally inspected, and which formats need specialist engines for perfect fidelity.
High-confidence Preview Lines
- PDF, OFD, images, audio, video, Markdown, source code, text, JSON/YAML/TOML/XML/SQL, archives, email, EPUB, Mermaid, Excalidraw, draw.io, and common Office/OpenDocument files.
- CAD preview is powered by
@flyfish-dev/cad-viewerthrough@file-viewer/renderer-cad; DWG, DXF, DWF, and DWFx assets stay self-hostable. - STEP / STP, IGES / IGS, and BREP preview uses a self-hosted OCCT worker, runtime, and WASM module to build renderable meshes locally, with orbit controls, fit-to-view, and unified zoom.
- Word preview uses
@file-viewer/renderer-wordand the self-maintained@file-viewer/docxpath for readable stream-style DOCX rendering. - Presentation preview uses
@file-viewer/renderer-presentationwith two isolated native engines: PowerPoint 97–2003.pptlazy-loads the independently versioned native-WASM@file-viewer/[email protected]runtime, while PPTX/OpenXML lazy-loads@file-viewer/pptxand its Worker. Full and CDN/IIFE distributions ship both routes' matching assets;@file-viewer/pptkeeps its included license and visible public watermark.
Structure-first Lines
Some engineering formats are intentionally conservative:
| Format family | Current behavior |
|---|---|
| OLB / DRA | Safe structure preview for common OrCAD / Allegro containers and readable metadata |
| OAS / OASIS | Readable fixtures render; complex binary OASIS stays structure-index focused until the dedicated layout kernel matures |
| IFC | Optional experimental local visual preview through @file-viewer/renderer-3d/ifc, with self-hosted That Open / web-ifc assets, fit, selection and property inspection; the official Demo includes IFC4 and IFC4.3 fixtures |
| 3DM | Signature detection and integration guidance; a dedicated rhino3dm renderer is still required for visual preview |
| PlantUML | Offline source/SVG-style preview by default; configure an intranet PlantUML service for full server-rendered SVG |
Verification
Use the built-in checks when the format matrix changes:
pnpm verify:format-support
pnpm verify:smoke-matrix
pnpm verify:renderer-assets