PHPackages                             lastdino/drawing-manager - 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. [Utility & Helpers](/categories/utility)
4. /
5. lastdino/drawing-manager

ActiveLibrary[Utility & Helpers](/categories/utility)

lastdino/drawing-manager
========================

Drawing management (folders, tags, revisions) for Laravel 12 with Livewire 3 & Flux UI.

v0.7(1mo ago)0198MITPHPPHP ^8.0

Since Nov 13Pushed 1mo agoCompare

[ Source](https://github.com/lastdino/drawing-manager)[ Packagist](https://packagist.org/packages/lastdino/drawing-manager)[ RSS](/packages/lastdino-drawing-manager/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (16)Used By (0)

Lastdino Drawing Manager
========================

[](#lastdino-drawing-manager)

English | [日本語](README.ja.md)

Drawing management (folders, tags, revisions) for Laravel 12 with Livewire 3 and Flux UI.

Features
--------

[](#features)

- Folder tree with lazy loading and virtualization
- Drawings listing with search and tag filters (OR/AND)
- Detail flyout with latest revision indicator
- Create / Edit drawings (number, title, folder, managing department, allowed roles, tags)
- Upload revisions (PDF creates a new revision; CAD attaches to an existing PDF revision)
- Secure downloads via policies (PDF and CAD types)
- Configurable CAD type aliases (e.g. map `stp` → `step`, `igs` → `iges`)

Requirements
------------

[](#requirements)

- PHP >= 8.4
- Laravel ^12.0
- Database tables for: `folders`, `tags`, `drawings`, pivot tables `drawing_tag`, `drawing_role`
- Spatie packages: `spatie/laravel-permission`, `spatie/laravel-medialibrary`
- Livewire 3, Flux UI 2

Note: This package ships its own Eloquent models (`Lastdino\\DrawingManager\\Models\\{DrawingManagerDrawing,DrawingManagerDrawingFolder,DrawingManagerDrawingTag}`) and migrations for greenfield projects. If your application already has equivalent tables/models, you can keep using them; simply do not run this package's migrations.

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

[](#installation)

1. Install the package

```
composer require lastdino/drawing-manager

```

If developing in a monorepo, add PSR-4 to your root `composer.json`:

```
{
  "autoload": {
    "psr-4": {
      "Lastdino\\\\DrawingManager\\\\": "packages/lastdino/drawing-manager/src/"
    }
  }
}

```

Then run `composer dump-autoload`.

2. Install required peer packages if not present

```
composer require livewire/livewire:^3.6 livewire/flux:^2.6 spatie/laravel-permission:^6.10 spatie/laravel-medialibrary:^11.12

```

3. Configure (optional)

```
php artisan vendor:publish --tag=drawing-manager-config --no-interaction

```

Config `config/drawing-manager.php`:

- `route_prefix`: UI mount path (default `drawings`)
- `middleware`: UI middleware (default `['web','auth']`)
- `authorize_download`: Check policy before streaming files (default `true`)
- `media_disk`: Disk used by Spatie Media Library (default `local`)
- `cad.aliases`: Normalize/alias CAD extensions. Keys are incoming extensions, values are canonical names.

Example configuration for CAD aliases:

```
return [
    // ...
    'cad' => [
        // When a user requests or uploads these extensions,
        // they will be treated as the canonical value on the right.
        'aliases' => [
            'stp' => 'step',
            'igs' => 'iges',
            'dft' => 'dxf',
        ],
    ],
];

```

4. Routes

---

The package auto-registers routes (names in parentheses):

- GET `/{prefix}` → drawings index (Livewire component) (`drawings.index`)
- GET `/{prefix}/{drawing}/latest/{type}` → download the latest file for type (`pdf`, `dwg`, `dxf`, `step`, `iges`) (`drawings.download.latest`)
- GET `/{prefix}/revisions/{media}` → download a specific media item (`drawings.download.revision`)

Remove conflicting host routes under the same prefix (default `/drawings`) if you had any.

Latest download behavior:

- The `{type}` segment is normalized using `config('drawing-manager.cad.aliases')`. For example, requesting `/drawings/{id}/latest/stp` returns the latest `step` file.
- For `pdf`, the latest media item is selected by checking a custom property `kind=pdf`, or by file extension / MIME type.
- For CAD, the latest media is selected by matching either `custom_properties: { kind: 'cad', cad_type: ... }` or by the file extension.

Authorization
-------------

[](#authorization)

A policy is registered automatically for the package model class only:

- `Lastdino\\DrawingManager\\Models\\DrawingManagerDrawing`

Default logic (`DrawingPolicy`):

- `view`/`download`: allowed if the user has any of the drawing's allowed role names. Admins bypass.
- `create`: allowed for admins; otherwise requires `department_id != null`.
- `update`: allowed for admins or if `user.department_id === drawing.managing_department_id`.

If you use a host app model such as `App\\Models\\Drawing`, register your own policy mapping for it in your application.

Downloads authorization:

- When `config('drawing-manager.authorize_download')` is `true` (default), downloads call `Gate::authorize('download', $drawing)` before streaming files.
- Set this to `false` only if you fully protect routes via middleware and are comfortable skipping per-model policy checks.

Livewire UI
-----------

[](#livewire-ui)

The UI uses Flux UI components. If you don't see changes, run your frontend builder:

- `npm run dev` or `composer run dev`

You can publish the package views to customize the UI:

```
php artisan vendor:publish --tag=drawing-manager-views --no-interaction

```

Testing
-------

[](#testing)

Use Pest or PHPUnit to write feature tests. Example:

```
use Lastdino\\DrawingManager\\Livewire\\Drawings\\Index;

it('shows drawings page', function () {
    $this->actingAs(User::factory()->create());
    $this->get('/drawings')->assertSeeLivewire(Index::class);
});

```

Download endpoint example (Pest):

```
it('downloads latest step using stp alias', function () {
    $user = User::factory()->create();
    $drawing = DrawingManagerDrawing::factory()->create();
    // attach media with custom properties: kind=cad, cad_type=step, revision=1
    // ...
    $this->actingAs($user)
        ->get("/drawings/{$drawing->getKey()}/latest/stp")
        ->assertOk();
});

```

Roadmap
-------

[](#roadmap)

- Publishable migrations for greenfield projects
- Download activity logs
- Thumbnails for PDFs
- S3 and external storage examples

Migrations
----------

[](#migrations)

This package ships migrations for greenfield projects and will auto-load them via the service provider. They are executed when you run `php artisan migrate`.

Tables provided:

- `folders` (self-referencing parent, unique per parent+name)
- `tags` (unique `slug`)
- `drawings` (unique `number`, FKs to `folders` and optionally to host `departments` if you reference it)
- `drawing_tag` (pivot)
- `drawing_role` (pivot to Spatie Permission `roles`)

Notes:

- If you already have equivalent tables in your app, simply do not run these migrations in a fresh environment that already contains your schema.
- Ensure Spatie Permission migrations are run before using this package's `drawing_role` pivot table.

Tips (UI / Build)
-----------------

[](#tips-ui--build)

- The UI is built with Livewire 3 and Flux UI. If frontend changes are not reflected, run your builder: `npm run dev` or `composer run dev`.
- When customizing the UI, consider publishing the package views and keeping your changes under version control.

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance90

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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 ~10 days

Recently: every ~30 days

Total

14

Last Release

47d ago

PHP version history (2 changes)v0.1PHP >=8.4

v0.3.1PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/2a91f54a5ec14785c7b8531214937c76ec0ec0874736a709c2bd973fdb9e619b?d=identicon)[lastdino](/maintainers/lastdino)

---

Top Contributors

[![lastdino](https://avatars.githubusercontent.com/u/87484368?v=4)](https://github.com/lastdino "lastdino (16 commits)")

### Embed Badge

![Health badge](/badges/lastdino-drawing-manager/health.svg)

```
[![Health](https://phpackages.com/badges/lastdino-drawing-manager/health.svg)](https://phpackages.com/packages/lastdino-drawing-manager)
```

###  Alternatives

[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4195.3M84](/packages/livewire-volt)[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[ramonrietdijk/livewire-tables

Dynamic tables for models with Laravel Livewire

21147.4k](/packages/ramonrietdijk-livewire-tables)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

2381.5k10](/packages/marcorieser-statamic-livewire)[aerni/livewire-forms

A Statamic forms framework powered by Laravel Livewire

2912.8k](/packages/aerni-livewire-forms)[team-nifty-gmbh/tall-datatables

A package to create datatables using alpinejs, tailwind, livewire and laravel

1217.2k1](/packages/team-nifty-gmbh-tall-datatables)

PHPackages © 2026

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