Create plugin for filament-swatch to work in Filaman

[akira69]

Filament Swatch looks totally cool and is a nice way to visualize your database of spools, etc.

• original repo: https://github.com/Disane87/spoolman-filament-swatch

Why not provide that function/capability within Filaman directly via plugin?

I was able to get Filament Swatch code working within Spoolman

• to Embed Filament Swatch into Spoolman, only few tweaks to that source code were necessary:
  • https://github.com/akira69/spoolman-filament-swatch/tree/feat/spoolman-hosted-mode
  • certainly more code changes would be needed on the filament-swatch side to interface to filaman rather than Spoolman - Though I broadly assume it'd not be too difficult.
• I had integrated Filament Swatch into Spoolman as proof of concept:
  • https://github.com/akira69/Spoolman_Labels/tree/feat/hosted-applications-framework-workspace
  • as Filaman already supports plugins, this may be be relatively easy - a lot of the spoolman work I had done for this was around "applications" - which Filaman basically solves by the existing plugin solution.
  • Here's an image of the tool embedded into Spoolman (would/could be similar in Filaman):

I'd give this one a 'nice to have' and would need agreement/alignment with Disane87 unless forked directly.

[akira69]

Status update: Still in the "nice to have" category and parked for now. Filaman's existing plugin architecture would make this relatively straightforward compared to the Spoolman embedding I had to do — no new framework needed. The blocker is coordination with @Disane87 (or a fork) to adapt the filament-swatch interface from Spoolman to Filaman's API. If there's upstream interest, this could be scoped as a plugin contribution relatively quickly.

[Disane87]

I need some more information about how to implement this. Are there any docs about filaman?

[akira69]

I need some more information about how to implement this. Are there any docs about filaman?

https://docu.filaman.app/ is all I know of
would be interesting to try to adapt your tool to a plugin
Filaman is similar to spoolman, but is more feature rich, more active in updates, and synchronized directly with NFC reader/scale tools that spoolman is only parallel to.

[Disane87]

@akira69 Will check that out, thank you!

[akira69]

@Disane87 :

Update: got this working as a proof of concept — since I already had the Spoolman hosted-mode integration done (PR I pulled on your repo awhile back), adapting it for FilaMan was fairly quick with some vibe coding. Here's what I needed on each side (all on my forks, nothing upstream yet):

akira69/spoolman-filament-swatch:

PR #6 — extend the SPA bootstrap to also read a filaman_hosted_config endpoint (alongside the Spoolman path I wrote earlier). Theme and locale are injected via query params automatically.
PR #7 — add a filaman-plugin/ package: FastAPI router that serves the SPA + exposes /hosted-config, a plugin.json manifest, and a release workflow that builds and publishes a tagged ZIP.

akira69/filaman-system

PR #23 — expose the existing spoolmanapi Spoolman-compat layer as real HTTP routes so the SPA's /api/v2/ calls resolve correctly when embedded in FilaMan.

PR #24 — add a /plugin-view/[slug] shell page: a full-height iframe that wraps the plugin SPA, injects hosted-mode params, and syncs dark/light theme + locale from FilaMan automatically. Generic enough to reuse for any iframe-able plugin.

End result: Filament Swatch shows up in the FilaMan nav and renders inside the existing layout with the sidebar intact. Happy to discuss if you'd want something like this upstream.

[akira69]

note the missing search bar: I opened a PR on your repo for that too... but not integrated here.