Tips and Troubleshooting

Restoring cubes to their real spots

Cattail.Nu SpaceCube pins your cubes to your immersive space, not just to the app. When you press Restore, it waits a few seconds for Vision Pro to recognize that space, then drops each cube back on the exact spot you left it. If it cannot recognize the space — because you have moved somewhere else, or surroundings sensing is off — the cubes come back arranged in front of you instead.

If cubes do not land where you expect: make sure you are in the same immersive space, give it a moment after pressing Restore, and check the permission below.

"Cubes can't be pinned in the immersive space" message

Pinning cubes needs permission to use your surroundings. If the app window shows this message, grant access under Settings › Privacy (world/surroundings sensing). Measuring still works without it; only the "land on the real spot" part of Restore needs it.

The workspace closed when I opened another app

That is expected: Vision Pro closes one app's immersive space whenever another app opens one. The small app window left behind in your Shared Space is what you come back to. Your layout is saved automatically, so press Restore there to bring the cubes back. Pause does the same thing on purpose.

Windows fade or shrink

This is by design:

Fading — a window dims when you are not looking near it, so a scene full of cubes stays readable. Look at it and it brightens again.
Growing with distance — a window gets larger as its cube moves away, so it looks the same size and stays readable. The cube itself never changes size.
Staying trim up close — a window stays small when near and never comes closer than about a foot, so it will not crowd your face.

Use the Window Size slider on the app window to set how big windows are overall (see Action - Minimize, Maximize, and Resize Windows).

A button will not highlight when I look at it

Buttons work by gaze and pinch: look at one so it highlights, then pinch. If highlights feel sticky right after a window moves, hold still for a moment and look again.

I can't add another cube

There is a limit of 12 cubes. When you hit it, the Spawn button reads "Cube Limit Reached" and is disabled. Destroy a cube you no longer need to free up a slot. See Action - Spawn and Remove Cubes.

I don't see a Save 3D button

That export needs enough cubes to make a shape. At exactly three cubes the button reads Save SVG; at four or more it reads Save 3D and lets you pick USDZ, OBJ, or STEP. The Save TXT report is always available. See Action - Save Your Data (TXT, SVG, 3D).

I don't see a Show Solid button

The shape needs four or more cubes to wrap. Below that there is nothing to cut, so the button is not shown. Drop to three cubes while a shape is up and it disappears on its own.

A workspace file will not open

A .spacecube file only opens in the version of the app that wrote it, and it has to be a SpaceCube workspace — the app says which of the two is wrong. If the file is fine but the cubes come back arranged in front of you instead of on their real spots, that is the same immersive‑space question as Restore, above.

Closing the app

There is no Quit button. Close the app window with its X: the cubes are pinned, your layout is written down, the scene closes, and the app ends. Restore brings it all back next launch.

Measurements read from centers

Every distance and angle runs from cube center to cube center, not from the surface. Turn on the pivot point and put that center right on your target.

Placing cubes far away

You do not have to reach a spot to put a cube there. Because input is look‑and‑pinch, you can ratchet a cube out past arm's length: pinch, push your hand away, release, then pinch and push again until it is as far out as you want. Pull back the same way to bring it closer. See Action - Move and Rotate a Cube.

So you can mark a point either by walking over to it or by pushing a cube out from where you stand. Keep in mind that landing a cube exactly on a distant real object is hard by eye — you have no depth cue out there. For accurate work, walk to the spot, or use features you can see up close.