PHPackages                             blackstone/laravel-nocodb - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. blackstone/laravel-nocodb

ActiveLibrary[Database & ORM](/categories/database)

blackstone/laravel-nocodb
=========================

NocoDB Eloquent Driver for Laravel

v1.1.2(4mo ago)01MITPHPPHP ^8.2

Since Nov 29Pushed 4mo agoCompare

[ Source](https://github.com/blackstone/laravel-nocodb)[ Packagist](https://packagist.org/packages/blackstone/laravel-nocodb)[ RSS](/packages/blackstone-laravel-nocodb/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (8)Versions (19)Used By (0)

NocoDB Eloquent Driver for Laravel
==================================

[](#nocodb-eloquent-driver-for-laravel)

A Laravel package that provides an Eloquent driver for NocoDB, allowing you to interact with NocoDB tables using standard Eloquent syntax.

Installation
------------

[](#installation)

1. Install via Composer:

```
composer require blackstone/laravel-nocodb
```

2. Publish the configuration file:

```
php artisan vendor:publish --tag=nocodb-config
```

Configuration
-------------

[](#configuration)

Add your NocoDB credentials to your `.env` file:

```
NOCODB_API_URL=https://app.nocodb.com
NOCODB_API_TOKEN=your-api-token
NOCODB_PROJECT=p_xxxx
NOCODB_WORKSPACE=optional
```

Usage
-----

[](#usage)

### Creating a Model

[](#creating-a-model)

Create a model and use the `NocoModelTrait`. Set the `$table` property to your NocoDB table name (or ID).

```
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use BlackstonePro\NocoDB\Traits\NocoModelTrait;

class Lead extends Model
{
    use NocoModelTrait;

    protected $table = 'leads'; // Or Table ID
    protected $primaryKey = 'Id'; // Default is Id
    protected $fillable = ['name', 'email', 'status', 'amount'];
}
```

### Querying

[](#querying)

You can use standard Eloquent methods:

```
// Get all leads
$leads = Lead::all();

// Filter and Sort
$leads = Lead::where('status', 'new')
    ->where('amount', '>', 500)
    ->orderBy('CreatedAt', 'desc')
    ->get();

// Pagination
$leads = Lead::paginate(25);

// Find by ID
$lead = Lead::find(1);
```

### Creating Records

[](#creating-records)

```
$lead = Lead::create([
    'name' => 'John Doe',
    'email' => 'john@example.com',
    'status' => 'new',
    'amount' => 1000
]);
```

### Updating Records

[](#updating-records)

```
$lead = Lead::find(1);
$lead->update(['status' => 'contacted']);

// Or via query (requires ID in where clause for now)
Lead::where('Id', 1)->update(['status' => 'contacted']);
```

### Deleting Records

[](#deleting-records)

```
$lead = Lead::find(1);
$lead->delete();

// Or via query
Lead::destroy(1);
```

Features
--------

[](#features)

- **Eloquent Compatibility**: Works with `where`, `orderBy`, `limit`, `offset`, `paginate`.
- **NocoDB API v2**: Uses the latest NocoDB REST API.
- **Automatic Retries**: Handles transient API failures.
- **Clean Code**: Follows Laravel standards.

License
-------

[](#license)

MIT

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance74

Regular maintenance activity

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Recently: every ~10 days

Total

18

Last Release

141d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/886b025ab82664cb06603c610067532bfa7b361b299a0af475278af70b94b0b9?d=identicon)[rkzn](/maintainers/rkzn)

---

Top Contributors

[![rkzn](https://avatars.githubusercontent.com/u/804692?v=4)](https://github.com/rkzn "rkzn (17 commits)")[![rarkhipovsw](https://avatars.githubusercontent.com/u/217712798?v=4)](https://github.com/rarkhipovsw "rarkhipovsw (1 commits)")

---

Tags

apilaraveldatabaseeloquentnocodb

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/blackstone-laravel-nocodb/health.svg)

```
[![Health](https://phpackages.com/badges/blackstone-laravel-nocodb/health.svg)](https://phpackages.com/packages/blackstone-laravel-nocodb)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8723.1M23](/packages/yajra-laravel-oci8)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9742.3M121](/packages/roots-acorn)[api-platform/laravel

API Platform support for Laravel

59156.3k11](/packages/api-platform-laravel)[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)[ntanduy/cloudflare-d1-database

Cloudflare D1 database driver for Laravel — full Eloquent & Query Builder support.

276.8k](/packages/ntanduy-cloudflare-d1-database)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)