@grapity/registry
v0.7.0
Published
Grapity Registry - spec validation, compat checking, and storage server
Readme
@grapity/registry
Grapity Registry Server - spec validation, backward compatibility checking, and versioned storage for API specs.
Documentation: grapity.dev/docs/platform/registry/overview · Quickstart
This is the server component. The CLI (@grapity/cli) communicates with this server over HTTP. Supports both SQLite (local) and PostgreSQL (production) backends.
Usage
Local mode (SQLite)
Zero infrastructure. Data stored in ~/.grapity/registry.db.
npm install -g @grapity/cli @grapity/registry
grapity init --local
grapity serve
# Server running on http://localhost:3750Self-hosted (PostgreSQL)
npm install -g @grapity/cli @grapity/registry
grapity serve --db postgresql://user:pass@host:5432/grapity --auth jwtAuth modes: none (default), api-key, jwt. Custom port via -p <port>.
Remote / SaaS
Point the CLI at a hosted Grapity instance. No server to run.
npm install -g @grapity/cli
grapity init --remote --url https://api.grapity.dev --api-key <key>Requirements
- Node.js 20+ or Bun 1.3.5+
- SQLite (local) or PostgreSQL 14+ (production)
Development
mise install # Install pinned tools (bun, npm, semver)
mise run setup # Install dependencies
mise run build # Build the package
mise run dev # Start the dev serverLicense
Apache-2.0
