1.0 Release

v1.0 — Final Release

Web App

URL: BlenderCollab

Sign Up

• Use a valid email for verification
• Recommend using a non-organization email or the verification email might get quarantined

Install the Blender Add-on

Installation Guide

What's New in 1.0

Web Dashboard:

• New marketing splash / landing page with project screenshots and a Downloads section for the Blender add-on
• Commits page redesigned with a dedicated history view and improved diff display
• Commit timestamps now render in the viewer's local timezone
• Input length limits added on project name, description, and commit messages
• Polish and bug fixes across project pages, commit detail view, and navigation

Blender Add-on:

• Auto-opens a project immediately after creation (no extra "Open Project" step)
• Self-heals stale branch IDs cached from a previous session — no more silent failures after a branch is deleted server-side
• All operators now have proper bl_description tooltips for in-Blender hover help
• Updated packaged ZIP in /export for 1.0 install

API / Backend:

• All boto3 S3 calls moved off the async event loop — large uploads, downloads, and deletes no longer block other requests
• S3 cleanup on project deletion fixed: previously it was silently skipping every object, leaving orphaned data in the bucket
• Account deletion no longer 500s when the user owns projects with branches
• Branch deletion now correctly handles names with special characters (slashes, spaces, unicode)
• FRONTEND_URL validated before use in outbound emails — closes a URL-injection vector in invitation and verification links
• S3 credentials are no longer returned in API responses to authenticated users

Security:

• Audit pass closing the three highest-severity findings (S3 credential exposure, email URL injection, async-blocking S3 calls)
• Tightened CORS and frontend-URL handling for production deploys

Other:

• Frontend Turbopack root pinned and lockfile refreshed — fixes intermittent dev-server resolution errors
• Expanded README with folder-level documentation and contributor guidance
• Test suite stabilized against current schemas and utility refactors

---

How to Use BlenderCollab

Web App

URL: blendercollab.pakshpatel.tech

Account Setup

1. Click Sign Up and register with a valid email address (avoid organization emails — verification may get quarantined)
2. Check your inbox and click the verification link — make sure to check your spam folder
3. Log in with your email and password

Creating a Project

1. From the Projects dashboard, click New Project
2. Enter a name and optional description
3. The project is created with a default "main" branch and opens automatically

Project Dashboard

• Branch selector (top right) — switch between branches, create new branches, delete non-default branches, or merge one branch into another
• Commits button — opens the commit history for the current branch. Click any commit to see a detailed diff (added/modified/deleted objects). Timestamps render in your local timezone
• Objects table — shows all objects in the latest commit on the current branch. Download objects as GLB (3D preview) or JSON (raw metadata)
• Last commit bar — shows the current branch name, latest commit author, message, and timestamp

Collaboration

1. On the project page, use the Invite Collaborator panel (right sidebar)
2. Enter a teammate's email or username and choose a role (Viewer / Editor / Owner)
3. They will see the invitation on their Invitations page and can accept or decline

Branching & Merging (Web)

1. Click the branch selector dropdown and click + New branch to create a branch from the current branch's HEAD
2. Switch between branches — commits and objects update automatically
3. To merge, click ↗ Merge into [current branch], select the source branch, and click Merge
4. If there are object-level conflicts, they must be resolved in the Blender add-on

---

Blender Add-on

Installation

• Follow the Installation Guide
• The BVCS panel appears in the 3D Viewport sidebar (press N to toggle, then click the BVCS tab)

Login & Project Selection

1. Click Sign Up to open the web registration page (if you don't have an account)
2. Click Login and enter your email and password
3. Click Open Existing Project to select a project, or Create Project to make a new one — newly created projects open automatically

Branching

• The Branch section shows your current branch (defaults to "main")
• Switch — pick a different branch from the dropdown
• New — create a new branch from the current branch's latest commit
• Delete — remove a non-default branch (commits are preserved). Branch names with slashes, spaces, or unicode are now handled correctly

Making Changes (Git-like Workflow)

1. Add, modify, or delete objects in your Blender scene
2. Click Refresh Status to see which objects are Added (+), Modified (M), or Deleted (-)
3. Stage objects for commit:
   • Stage Selected — stages only the selected objects in the viewport
   • Stage All — stages every changed object
   • Unstage — removes an object from the staging area
   • For deleted objects, click the trash icon next to them in the status list
4. Click Commit — enter a commit message describing your changes
5. Click Push to Remote — uploads changed objects to S3 and creates the commit on the server. Only the active branch is updated

Pulling Changes

1. Click Pull from Remote — downloads the latest commit from the active branch and reconstructs the scene
2. If there are merge conflicts (you and a teammate both changed the same object), the panel shows a Merge Conflicts section:
   • Each conflicting object has a resolution dropdown: Keep Local, Keep Remote, Keep Both (imports remote as ObjectName.remote), or Delete
   • Click Preview Remote Side to see the remote version in a separate window
   • Click Apply Resolutions to create a merge commit with your choices

Loading a Previous Commit

1. Use the Commits dropdown to select any previous commit on the active branch
2. Click Load — clears the scene and reconstructs it from that commit's objects
3. Your sync state updates to that commit

RC1 Release

v0.9 — RC1 Release

Web App

URL: BlenderCollab

Sign Up

• Use a valid email for verification
• Recommend using a non-organization email or the verification email might get quarantined

Install the Blender Add-on

Installation Guide

What's New in RC1: Branching

Web Dashboard:

• Branch selector dropdown on the project page — create, switch, delete, and merge branches
• Commits are now filtered per branch
• Branch name and merge badges shown on commits

Blender Add-on:

• Branch panel in the N-panel (Switch / New / Delete)
• Push and pull now operate on the active branch (defaults to "main")
• "Load Commit" dropdown lets you checkout any previous commit at the object level (replaces old .blend file picker)

API:

• Full branch CRUD: GET/POST/DELETE /api/projects/{id}/branches
• Server-side merge with fast-forward and auto-merge: POST /api/projects/{id}/branches/{id}/merge
• Commits and locks are now branch-scoped
• Existing projects auto-create a "main" branch on first access

---

How to Use BlenderCollab

Web App

URL: blendercollab.pakshpatel.tech

Account Setup

1. Click Sign Up and register with a valid email address (avoid organization emails — verification may get quarantined)
2. Check your inbox and click the verification link make sure to check your spam folder
3. Log in with your email and password

Creating a Project

1. From the Projects dashboard, click New Project
2. Enter a name and optional description
3. The project is created with a default "main" branch

Project Dashboard

• Branch selector (top right) — switch between branches, create new branches, delete non-default branches, or merge one
  branch into another
• Commits button — opens an overlay showing the commit history for the current branch. Click any commit to see a detailed
  diff (added/modified/deleted objects)
• Objects table — shows all objects in the latest commit on the current branch. Download objects as GLB (3D preview) or JSON
  (raw metadata)
• Last commit bar — shows the current branch name, latest commit author, message, and timestamp

Collaboration

1. On the project page, use the Invite Collaborator panel (right sidebar)
2. Enter a teammate's email or username and choose a role (Viewer / Editor / Owner)
3. They will see the invitation on their Invitations page and can accept or decline

Branching & Merging (Web)

1. Click the branch selector dropdown and click + New branch to create a branch from the current branch's HEAD
2. Switch between branches — commits and objects update automatically
3. To merge, click ↗ Merge into [current branch], select the source branch, and click Merge
4. If there are object-level conflicts, they must be resolved in the Blender add-on

---

Blender Add-on

Installation

• Follow the Installation
  Guide
• The BVCS panel appears in the 3D Viewport sidebar (press N to toggle, then click the BVCS tab)

Login & Project Selection

1. Click Sign Up to open the web registration page (if you don't have an account)
2. Click Login and enter your email and password
3. Click Open Existing Project to select a project, or Create Project to make a new one

Branching

• The Branch section shows your current branch (defaults to "main")
• Switch — pick a different branch from the dropdown
• New — create a new branch from the current branch's latest commit
• Delete — remove a non-default branch (commits are preserved)

Making Changes (Git-like Workflow)

1. Add, modify, or delete objects in your Blender scene
2. Click Refresh Status to see which objects are Added (+), Modified (M), or Deleted (-)
3. Stage objects for commit:
   • Stage Selected — stages only the selected objects in the viewport
   • Stage All — stages every changed object
   • Unstage — removes an object from the staging area
   • For deleted objects, click the trash icon next to them in the status list
4. Click Commit — enter a commit message d...

Beta Release

Web Link
BlenderCollab

Sign up

• Use valid email for verification
• Recommend using non organization email or verification email might get quarantined

Instruction to Install Add-on
Here

Testing Milestone

This release contains the testing files for both unit and behavioral tests.

Proof of Concept

v0.1

Hope this works