Skip to content

🖼️ User Dashboard Deep Dive

The User Dashboard, typically located in the top-right corner of the StorySplat editor, is your primary control center for managing scenes saved to your account, checking storage, handling uploads/updates, and accessing account-related features.

Dashboard Overview

![Placeholder for User Dashboard Screenshot] (Add a screenshot highlighting the key areas)

The dashboard dynamically changes based on whether you are logged in and whether you currently have a scene loaded in the editor.

Key Sections:

  1. Account Info & Actions: Displays your username, subscription tier (Free, Plus, Business, Admin), and provides buttons for managing your profile, subscription, or signing out.
  2. Storage Info: Shows your current usage against your plan's limits for the number of saved scenes (splats) and total storage space (in GB). Includes a progress bar for storage bytes.
  3. Main Action Button (Save/Upload/Update): This button's function changes contextually (details below).
  4. Splat List: Displays all the scenes (splats) currently saved to your account.
  5. Splat Item Controls: Provides actions for each individual saved splat in the list.

Account Info & Actions

  • Username & Tier Badge: Identifies the logged-in user and their current subscription level.
  • Manage Profile: Navigates to the /manage-profile page where you can edit your public profile details (display name, slug, bio, links, visibility). See Public Profiles.
  • View Profile: Opens your public profile page (/profile/[your-slug]) in a new tab (if your profile is set to public).
  • Upgrade to Plus / Manage Subscription / Account Settings:
    • If Free: Shows "Upgrade to Plus", linking to the /upgrade-to-pro page.
    • If Plus/Business/Admin: Shows "Manage Subscription" or "Account Settings", linking securely to the Stripe Customer Portal (or potentially a dedicated settings page) for billing management. See Account Management.
  • Sign Out (Logout Icon ): Logs you out of your StorySplat account.

Storage Info

  • Saved Scenes: Shows [Current Scenes] / [Max Scenes]. "Unlimited" is shown if your plan has no limit.
  • Storage: Shows [Storage Used GB] / [Max Storage GB]. "Unlimited" is shown if your plan has no storage byte limit.
  • Progress Bar: Visually represents your used storage percentage relative to your limit.

Main Action Button (Contextual)

The large button below the Storage Info changes its text and function:

  • "Save Project" (): Appears when you have loaded content (splat + waypoints) but haven't yet saved it to your account, or if you've explicitly used "File -> New". Clicking this opens the Upload Scene Configuration popup to save the current state as a new scene entry in your account.
  • "Publish Changes" (): Appears when you have loaded a scene that is already saved in your account (identified by currentLoadedSceneId). Clicking this opens the Update Scene Configuration popup, allowing you to update the existing saved scene entry.
  • Disabled State: The button is disabled if:
    • No splat is loaded OR no waypoints have been created.
    • You are on the Free/Plus plan and have reached your scene count limit (only when trying to save a new project).
    • An upload/update process is currently running (isUploading).

Splat List & Item Controls

This section lists all scenes saved to your account. Each item provides several actions:

  • Splat Name & Description: Displays the title and optional description of the scene.
  • Visibility Toggle (👁️ / ): Click to switch the selected splat between Public and Private. Affects appearance on Discover/Profile pages. (Requires Plus+ for Private setting).
  • Copy Embed Code (📋): Get the <iframe> code to embed the splat viewer directly into your website or blog.
  • Open in New Tab (🔗): View the splat's direct view URL (e.g., /[ProfileSlug]?sceneId=[SceneID]) in a new browser tab.
  • Edit Scene (✏️): Load this specific splat and its saved configuration (waypoints, hotspots, settings) into the editor, replacing any currently loaded scene. The "Publish Changes" button will then target this scene ID.
  • Delete Scene (🗑️): Permanently remove the splat and all associated data (config, HTML, assets) from your account and storage. Irreversible. A confirmation prompt appears first. Disabled during deletion (isDeletingId).

Controls Visible Only When Editing That Scene:

These controls appear only for the splat entry that matches the currentLoadedSceneId (the one currently loaded in the editor):

  • "Currently editing" Indicator: Text indicating this is the active scene.
  • Edit Splat (✏️ - SuperSplat): Launches the integrated SuperSplat editor to modify the base splat data. See SuperSplat Integration. May be disabled for certain formats.
  • Replace Splat Model (🔄): Opens a file dialog. Allows you to upload a new .splat, .ply, .spz, .glb, or .gltf file to replace the visual data for the current scene configuration, keeping your existing waypoints/hotspots/settings intact.
  • Update Section:
    • Save File (): Updates only the scene's .json configuration file in your cloud storage. Faster for saving frequent config changes without regenerating the viewer.
    • Update Published Splat (): Updates the .json config file and regenerates/re-uploads the public-facing HTML viewer file. Use this when you want changes to be reflected in embedded views or direct links immediately. (This button is inside a Tooltip explaining it also saves the file).
    • Set Preview Image (): Captures the current 3D viewport as the thumbnail image for this splat, overwriting any previous thumbnail.

Popups (Upload/Update)

Clicking "Save Project" or "Publish Changes" opens the Export Popup component, configured for either "Upload" (new scene) or "Update" (existing scene) mode. This allows final configuration of export/publishing settings like Title, Description, Visibility, Layout, Navigation Modes, XR options, etc., before the final save/update action is committed. See Export Settings Deep Dive for details on these options.

Previous: Account Management & Billing | Next: Public Profiles