A local-first, zero-setup visual database for your JSON files. Features spreadsheet-like editing, centralized Zod schema generation (like Drizzle), TypeScript-first validation, and smart file management. Perfect for developers working with JSON data.
JsonBoard is a local-first, zero-setup visual database for your JSON files. Get a spreadsheet-like GUI to edit JSON data without leaving your project.
Skip the complexity of Drizzle, Prisma, or SQLite for small projects. No more manual JSON editing in VS Code or downloading-uploading from online tools. Just run npx jsonboard and get a full-featured GUI that feels like Google Sheets meets phpMyAdmin.
๐ Read Full FAQ & Use Cases | ๐ Quick Start | ๐ก Real-World Examples
# Run in any project directory
npx jsonboard
# Specify custom directory
npx jsonboard --dir ./my-data
# Use custom port (auto-detects conflicts)
npx jsonboard --port 8080
# Don't open browser automatically
npx jsonboard --no-open
# Install globally
npm install -g jsonboard
jsonboard --help
# ๐งฉ JsonBoard Pro
# A local-first visual database for your JSON files
# Get a spreadsheet-like GUI to edit JSON data without leaving your project.
# ๐ Documentation: https://github.com/sh20raj/jsonboard
# Usage: jsonboard [options]
# Options:
# -V, --version display version number
# -d, --dir <directory> Directory to scan for JSON files (default: current directory)
# -p, --port <port> Port to run the server on (default: 3000, auto-detects conflicts)
# --no-open Don't automatically open the browser
# -h, --help Display help information
# Examples:
# # Start JsonBoard in current directory
# jsonboard
# # Specify a custom directory
# jsonboard --dir ./my-data
# # Use a specific port
# jsonboard --port 8080
# # Don't open browser automatically
# jsonboard --no-open
/data foldernode_modules, .next, .git, etc.| JsonBoard | vs. Traditional DB | vs. Headless CMS | vs. Spreadsheets |
|---|---|---|---|
| โ 0-minute setup | โ Hours of config | โ Account setup | โ Poor dev integration |
| โ Git-friendly | โ Migration complexity | โ External dependency | โ No version control |
| โ Visual + Code | โ Query language | โ Limited customization | โ Not developer-focused |
| โ Free forever | โ Server costs | โ Monthly fees | โ Feature limitations |
| โ Offline-first | โ Network dependency | โ Internet required | โ Cloud dependency |
Manage your projects, skills, and experience visually:
portfolio/
โโโ data/
โ โโโ projects.json # Add/remove projects instantly
โ โโโ skills.json # Update your tech stack
โ โโโ experience.json # Manage work history
โ โโโ testimonials.json # Client feedback
Perfect for: Freelancers, developers showcasing work, agencies updating portfolios
Content management without the CMS complexity:
blog/
โโโ data/
โ โโโ posts.json # Blog post metadata & content
โ โโโ authors.json # Writer profiles
โ โโโ categories.json # Content organization
โ โโโ featured.json # Homepage highlights
Perfect for: Personal blogs, company blogs, documentation sites, news sites
Build product catalogs quickly:
store/
โโโ data/
โ โโโ products.json # Product listings with details
โ โโโ categories.json # Product organization
โ โโโ inventory.json # Stock tracking
โ โโโ promotions.json # Sales and discounts
Perfect for: MVP development, client demos, prototype testing, small businesses
Manage game data without databases:
game/
โโโ data/
โ โโโ levels.json # Level design and progression
โ โโโ characters.json # Player and NPC stats
โ โโโ items.json # Weapons, armor, collectibles
โ โโโ leaderboard.json # High scores and achievements
Perfect for: Indie developers, game jams, prototype testing, balance tweaking
Quick business applications:
business/
โโโ data/
โ โโโ customers.json # Customer database
โ โโโ invoices.json # Billing and payments
โ โโโ inventory.json # Stock management
โ โโโ employees.json # Staff information
Perfect for: Small businesses, freelancers, local services, consultants
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐งฉ JsonBoard Pro - users.json (4 records, 2.1 KB) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ # โ id โ name โ email โ role โ โ๏ธ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ 1 โ 1 โ John Doe โ john@example.com โ admin โ ๐๏ธ โ
โ 2 โ 2 โ Jane Smith โ jane@example.com โ user โ ๐๏ธ โ
โ 3 โ 3 โ Bob Wilson โ bob@example.com โ editor โ ๐๏ธ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ Add Row โ
[
{
"id": 1,
"name": "John Doe",
"email": "john@example.com",
"role": "admin",
"created_at": "2025-01-01T00:00:00Z"
}
]
๐ /your-project (5 JSON files found)
๐ posts.json 4 records 3.2 KB Blog posts
๐ users.json 12 records 1.8 KB User accounts
๐ products.json 89 records 15.4 KB Product catalog
๐ config.json 1 record 0.5 KB App settings
๐ testimonials.json 6 records 2.1 KB Client feedback
/data foldernode_modules, .next, .git, etc.--help command with examples and GitHub link--port flag for specific port assignment/api/files, /api/files/:filename)JsonBoard is 100% open source because we believe developers should have:
We welcome all types of contributions! Here's how you can help make JsonBoard better:
Every contribution matters! From typo fixes to major features, we appreciate all help in making JsonBoard the best tool for JSON data management.
JsonBoard draws inspiration from the best developer tools:
MIT License - feel free to use in personal and commercial projects.
Made with โค๏ธ by SH20RAJ and the open source community.
[1.4.0] - 2025-07-11
--init-schema command creates a single jsonboard.schema.ts fileimport { usersSchema, productsSchema } from './jsonboard.schema'UsersSchemaType, ProductsSchemaType, etc.jsonboard.schema.ts file (no folder pollution)--generate-schema still available for individual files# Generate centralized schema file
jsonboard --init-schema
FAQs
A local-first, zero-setup visual database for your JSON files. Features spreadsheet-like editing, centralized Zod schema generation (like Drizzle), TypeScript-first validation, and smart file management. Perfect for developers working with JSON data.
The npm package jsonboard receives a total of 42 weekly downloads. As such, jsonboard popularity was classified as not popular.
We found that jsonboard demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.ย It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Application Security
/Security News
Socket CEO Feross Aboukhadijeh and a16z partner Joel de la Garza discuss vibe coding, AI-driven software development, and how the rise of LLMs, despite their risks, still points toward a more secure and innovative future.
Research
/Security News
Threat actors hijacked Toptalโs GitHub org, publishing npm packages with malicious payloads that steal tokens and attempt to wipe victim systems.
Research
/Security News
Socket researchers investigate 4 malicious npm and PyPI packages with 56,000+ downloads that install surveillance malware.