Skip to content

Fileament v1.2.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 30 Jul 23:25
v1.2.0
e98d3fd
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Fileament v1.2.0

Fileament 1.2.0 makes it easier to organize related model files, improves the browser viewer, and cleans up how release artifacts are built and distributed.

Warning

Fileament is still in the early stages of development. Back up your /data volume and review the release notes before updating.

Highlights

Organize models while uploading

Uploads can now be assigned to a collection before they finish. Fileament keeps the collection state in sync if an upload is canceled or removed.

When several loose STL, OBJ, or 3MF files belong to the same model, select One model with variants to create a single library entry. Grouped uploads are validated and persisted together, so an invalid variant does not leave behind a partial model. ZIP archives continue to create their own bundled models.

Better model details and viewer controls

  • Download the currently selected variant directly from the model detail sidebar.
  • Zoom the 3D viewer in or out and reset the camera with compact viewer controls.
  • Choose a model color for STL and OBJ previews.
  • Keep the selected viewer color in browser-local storage, with safe fallback behavior when storage is unavailable.
  • Use consistent variant terminology across uploads, model details, and public shares.

Cleaner standalone releases

The production container still ships Fileament as one standalone Go executable with the complete web interface embedded. Generated Vite bundles are no longer stored in Git. Production Docker builds stage the generated frontend inside the builder and embed it into the release binary.

This keeps source checkouts cleaner while preserving the single-binary production artifact.

Public documentation and AGPL licensing

  • Reworked the README around installation, configuration, backups, updates, security, and everyday use.
  • Added a repository-wide AGENTS.md guide for contributors and coding agents.
  • Licensed Fileament under AGPL-3.0-only.

Upgrade notes

Official container users do not need a database schema migration or production configuration change. Existing /data volumes remain compatible.

Untagged binaries built directly from source now load the frontend from web/dist by default. Run npm run build from web/ before starting one, or set FILEAMENT_WEB_DIR to another directory containing the built frontend. Official production images embed the frontend and do not use this setting.

Back up the complete /data volume before updating. The versioned image is available for linux/amd64 and linux/arm64:

docker pull ghcr.io/techhuttv/fileament:1.2.0

If you use Docker Compose, update the image tag and recreate the service:

docker compose pull
docker compose up -d

Changes by pull request

feat: refine model library and viewer UX by @TechHutTV

  • Added optional collection assignment for queued uploads, including cleanup when an upload is canceled.
  • Added a download action for the currently selected model variant.
  • Added compact zoom and reset controls to the 3D viewer.
  • Added browser-local model color presets for STL and OBJ previews.
  • Hardened upload cleanup and viewer preferences when browser storage is unavailable.

feat: add grouped model uploads by @TechHutTV

  • Added explicit One model with variants organization for multiple loose mesh files.
  • Preserved separate-model defaults for loose files and existing ZIP bundle behavior.
  • Added atomic grouped-model creation with staged validation and rollback on invalid variants.
  • Prevented duplicate variant filenames from overwriting one another.
  • Standardized variant terminology across uploads, model details, and public shares.

Keep generated frontend assets out of Git by @TechHutTV

  • Removed generated Vite bundles from source control.
  • Added separate external-development and embedded-release frontend providers.
  • Preserved the standalone production binary by staging generated assets only inside the Docker builder.
  • Added CI protection against recommitting generated frontend output.

Add public README and AGPL license by @TechHutTV

  • Added a prominent early-development and upgrade warning.
  • Reworked the README around public installation, configuration, backups, updates, security, and source builds.
  • Added the repository-wide AGENTS.md contributor guide.
  • Licensed Fileament under AGPL-3.0-only with the canonical GNU license text.

Full changelog: v1.1.0...v1.2.0

Assets 2
Loading