Files
jsonPrism/README.md
T
poli0981andClaude Opus 4.7 27743986cc feat: UI/UX polish — Multi-target slogan, dynamic placeholders, social, reverse highlight, mobile (#35)
* feat(i18n): dynamic placeholders + Multi-target slogan

- Replace "Eight target formats" with "Multi-target formats" in app.description across en/vi/ja/zh-CN
- Add input_placeholder_format and output_empty_format keys with {{ext}} interpolation
- InputPanel and OutputPanel render extension-aware placeholders in reverse mode (e.g. "Paste your CSV here...", "Output will appear here once you provide valid YAML.")
- Forward mode keeps the original JSON-specific copy

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(ui): social links in Footer + About Community section

- Add SocialIcons component with 6 inline-SVG brand icons (Discord, X, Bluesky, Mastodon, Telegram, YouTube), since lucide-react has no brand icons
- Footer now exposes Discord (dev community) / X / Bluesky as a centered icon row, sandwiched between app meta and the maintainer credit
- About page gains a "Community" section between Donate and Third-party, listing all six platforms with icon + label
- Add i18n keys: about.community.* (titled section) and social.* (aria-labels) across en/vi/ja/zh-CN
- Curated based on username.txt: includes dev-relevant + maintainer's public socials; excludes Steam, Discord game server, email, and the Telegram bot (off-topic for the project)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(editor): scroll polish + reverse highlight for md/sql/toml/jsonl

Scroll fix
- .cm-scroller switched from scrollbarWidth: 'none' to 'thin' and explicit overflow: 'auto'. Hiding the native scrollbar was making wheel scroll require a click-to-focus before it engaged on some Chromium builds. Thin themed scrollbar reads fine on both light and dark theme.

Reverse-mode highlight
- Add @codemirror/lang-markdown, @codemirror/lang-sql, @codemirror/legacy-modes
- CodeEditor's EditorLanguage union now covers markdown, sql, and toml
- InputPanel maps jsonl -> json, markdown -> markdown, sql -> sql, toml -> toml; csv/tsv stay plain (no good CodeMirror grammar)
- All extensions go through the existing prismHighlightStyle, so colors stay consistent with forward JSON highlighting

Bundle impact: the three new packs are routed into the existing 'codemirror' manualChunk; no initial-bundle regression.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(ui): mobile responsiveness polish

- Header: nav links Convert/About now always visible (previously hidden md:flex), brand mark + wordmark scale down on small screens, padding tightened to 12px so the 360px viewport fits brand + nav + lang + theme + GitHub icon
- InputPanel/OutputPanel toolbar buttons: icon-only on mobile (label hidden below sm); aria-label and title now carry the text for a11y/tooltips
- ConverterWorkspace panels: min-h-[40vh] on mobile so the stacked Input/Output each keep a usable height instead of collapsing
- Home hero: stack the title and the drop-zone hint on mobile (flex-col), reduce outer padding
- About page: reduce outer padding on mobile (px-4 py-10) to claw back horizontal space
- FormatPicker chips: smaller padding + 11px font on mobile so the 12-format wrap stays compact

Skipped hamburger menu by design — Header only has 2 nav links, the drawer pattern adds bundle and complexity without payoff.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs: refresh README EN + VI for Multi-target slogan, full format table, Community section

- Replace "Eight target formats" tagline with "Multi-target formats" (EN) / "Đa định dạng đích" (VI), matching the in-app app.description copy
- VI README format table now mirrors EN: includes BSON / CBOR / MessagePack (Phase 4) and the "Reverse (→ JSON)" column that the VI side was missing
- Bump tech-stack line from Vite 6 to Vite 8 in both files (package.json has been on ^8.0.0 for a while; the About page already reflected this)
- Add a Community section listing Discord (dev community), X, Bluesky, Mastodon, Telegram, and YouTube — same set as the in-app Community section, sourced from the maintainer's public socials

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 10:27:04 +07:00

9.6 KiB

JSONPrism

Disperse JSON into many formats.

One JSON input. Multi-target formats. Fully in your browser.

CI Deploy License: Apache 2.0

Live demo · Tiếng Việt · Roadmap


JSONPrism is a refracting tool for developers. It takes a single JSON input and disperses it into many target formats — like white light through a prism. Everything runs client-side, so your data never leaves your device.

Target formats

Format Extension Status Reverse (→ JSON)
JSONL .jsonl ✅ Phase 1 ✅
CSV .csv ✅ Phase 1 ✅
TSV .tsv ✅ Phase 1 ✅
YAML .yaml ✅ Phase 1 ✅
XML .xml ✅ Phase 2 —
TOML .toml ✅ Phase 2 ✅
Markdown table .md ✅ Phase 2 —
SQL INSERT .sql ✅ Phase 2 —
RESX (.NET) .resx ✅ Phase 3 ✅
BSON .bson ✅ Phase 4 —
CBOR .cbor ✅ Phase 4 —
MessagePack .msgpack ✅ Phase 4 —

Features

  • Client-side only — no server, no telemetry, no upload. Your JSON stays in your browser.
  • Batch processing — up to 500 files at once (Phase 2).
  • Smart shape detection — recognizes flat objects, arrays of objects, scalars; suggests the best target format.
  • Per-format options — pretty-print, indentation, dialect (for SQL), alignment (for Markdown), and more.
  • Dark + light themes — Prism Spectrum palette with violet / cyan / amber / rose accents.
  • EN + VI — bilingual interface out of the box. More languages welcome.
  • Tauri desktop build — drag-and-drop file workflow, offline-first (Phase 2 milestone).

Tech stack

  • Vite 8 + React 19 + TypeScript 5.7
  • Tailwind CSS v4 + shadcn/ui (New York style, neutral base)
  • CodeMirror 6 for the input editor (Phase 1 polish)
  • PapaParse, js-yaml, smol-toml, fast-xml-parser for parsing/serialization
  • i18next for translations, Zustand for state, Sonner for toasts
  • Tauri 2 wrapper (Phase 2)

Quick start

Requirements: Node.js 22 LTS or newer.

git clone https://github.com/poli0981/jsonPrism.git
cd jsonprism
npm install
npm run dev          # http://localhost:5173

Desktop app (Tauri 2)

JSONPrism also ships as a native desktop app via Tauri 2. The app uses the same React UI, with native OS dialogs and drag-drop hooked into the existing batch flow.

Additional requirements:

  • Rust toolchain (rustup) with the stable channel
  • Platform build deps:
    • Windows: Visual Studio Build Tools (C++ workload) + WebView2 (preinstalled on Windows 11)
    • macOS: Xcode Command Line Tools (xcode-select --install)
    • Linux: libwebkit2gtk-4.1-dev, libappindicator3-dev, librsvg2-dev, patchelf, libssl-dev

Generate icons once (uses Tauri's CLI to render the SVG to PNG/ICO/ICNS):

npm run tauri:icon

Run in dev mode (Vite + Tauri window with hot reload):

npm run tauri:dev

Build native bundles:

npm run tauri:build

Output:

  • Windows → src-tauri/target/release/bundle/msi/*.msi + nsis/*-setup.exe
  • macOS → src-tauri/target/release/bundle/dmg/*.dmg + macos/*.app
  • Linux → src-tauri/target/release/bundle/appimage/*.AppImage + deb/*.deb

Automated releases: pushing a v* tag triggers .github/workflows/release.yml, which builds for all platforms in parallel and creates a draft GitHub release.

Scripts

Script What it does
npm run dev Start Vite dev server with HMR
npm run build Production build to dist/
npm run preview Preview the built site locally
npm run lint Run ESLint
npm run lint:fix Run ESLint with autofix
npm run typecheck TypeScript type-check, no emit
npm run format Format with Prettier
npm run format:check Check formatting (CI uses this)

shadcn/ui components

The components.json is preconfigured. Add components on demand:

npx shadcn@latest add button input textarea tabs select card dialog sheet \
  dropdown-menu switch badge progress tooltip sonner resizable

Architecture

src/
├── app/                 # Router + global providers
├── components/
│   ├── ui/              # shadcn components (added on demand)
│   ├── layout/          # Header, Footer, ThemeToggle
│   ├── converter/       # Workspace, panels, format picker
│   └── common/          # ErrorBoundary, LanguageSwitcher
├── converters/          # One module per target format
│   ├── types.ts         # Converter interface
│   ├── registry.ts      # Lookup table
│   └── *.ts             # Per-format implementations
├── hooks/               # Custom hooks
├── i18n/                # Translations (en, vi)
├── lib/                 # detect, theme, utils, sample
├── pages/               # Home, About
├── styles/              # globals.css (Tailwind + theme tokens)
└── main.tsx

Adding a new format

Each format is a self-contained module implementing the Converter interface:

import type { Converter } from './types';

interface MyFormatOptions {
  indent: 2 | 4;
}

export const myFormatConverter: Converter<MyFormatOptions> = {
  meta: {
    id: 'myformat',
    labelKey: 'formats.myformat',
    extension: 'myf',
    mimeType: 'application/x-myformat',
    phase: 1,
    ready: true,
  },
  defaultOptions: { indent: 2 },
  convert({ data }, options) {
    try {
      const output = serialize(data, options);
      return { ok: true, output };
    } catch (err) {
      return { ok: false, error: (err as Error).message };
    }
  },
};

Then register it in src/converters/registry.ts and add label keys to src/i18n/locales/*.json.

See docs/ROADMAP.md for the full phase plan.

Contributing

Pull requests welcome — please read CONTRIBUTING.md first. PRs that match the auto-ignored patterns described there (suspicious code, off-topic preamble, no description, etc.) get closed without review.

For bug reports and feature requests, use GitHub Issues. For security vulnerabilities, use the private Security Advisory flow.

Project docs

Doc What's in it
PRIVACY.md Offline-first, localStorage-only, no telemetry.
TERMS.md ToS / EULA — acceptable use, license inheritance, user data ownership.
SECURITY.md How to report vulnerabilities; response SLAs.
DISCLAIMER.md One-person + AI-assisted project; no warranty.
THIRD-PARTY.md Every dependency: version, license, link.
MAINTAINERS.md Who's responsible for what.
CODE_OF_CONDUCT.md Contributor Covenant v2.1.
docs/ROADMAP.md Phase plan, current status.
docs/pc_spec.md · docs/dev_env.md Maintainer's hardware + toolchain.
docs/TAURI-NOTES.md Tauri build / process notes.
docs/RESX-MIGRATION.md i18next JSON → .NET RESX tutorial.

Community

Hang out, ask questions, or follow updates:

Acknowledgements

Substantial parts of JSONPrism's code, tests, translations, and docs were drafted with Claude Chat and Claude Code (Opus 4.7, 1M context). See DISCLAIMER.md for the full AI-assist disclosure. Translation quality for non-English locales is best-effort and contributions from native speakers are welcomed.

Sponsorship

If JSONPrism is useful to you, consider sponsoring the maintainer via any of the channels in .github/FUNDING.yml: GitHub Sponsors, Ko-fi, Buy Me a Coffee, Patreon, or PayPal.

License

Apache License 2.0 — © 2026 Kokone (@poli0981).