instant.dev  by instant-dev

CLI tool for JavaScript + Postgres API framework with ORM, migrations, and vectors

created 1 year ago
269 stars

Top 96.2% on sourcepulse

GitHubView on GitHub
Project Summary

Instant.dev provides a JavaScript/TypeScript ORM and API framework for PostgreSQL, inspired by Ruby on Rails' ActiveRecord. It targets Node.js, Deno, and Bun developers seeking a robust, production-tested solution for building APIs with features like migrations, vector support for AI integration, and complex query composition. The framework has been used in production since 2016, managing over a billion records.

How It Works

Instant.dev leverages a convention-over-configuration approach, offering a fluent API for database interactions. It generates migrations, models, and endpoints, simplifying development. Key features include built-in support for pgvector, allowing seamless integration of AI capabilities, and a powerful query builder that supports complex joins, transactions, input validation, and lifecycle callbacks. Its design prioritizes developer experience and rapid development.

Quick Start & Requirements

  • Install globally: npm i instant.dev -g
  • Initialize project: cd ~/projects/my-awesome-project && instant init
  • Requires PostgreSQL 13+.
  • Optional: OpenAI API key for vector engine.
  • Documentation: instant.dev

Highlighted Details

  • Full ORM with CRUD, transactions, input validation, and lifecycle callbacks.
  • Built-in pgvector support for AI-powered vector fields and search.
  • Code generation for models, migrations, endpoints, and relationships.
  • "Kits" for pre-built functionality like authentication.
  • Supports Vercel and Autocode deployment targets.

Maintenance & Community

  • Active development, with core contributors Scott Gamble and Keith Horwood.
  • Community channels: Discord (discord.gg/puVYgA7ZMh), X (@instantdevs).

Licensing & Compatibility

  • MIT License.
  • Compatible with commercial and closed-source applications.

Limitations & Caveats

The framework is primarily focused on PostgreSQL. While it supports multiple JavaScript runtimes (Node.js, Deno, Bun), extensive testing across all might be limited. The "Kits" are noted to support Autocode and Vercel specifically.

Health Check
Last commit

11 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
0 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.