HxAR 2.0 is a development preview.Current App Store release: HxAR 1.2 ↗

How To Topic 04 · Settings

How to Personalise HxAR Settings

The blue gear opens HxAR’s control centre for appearance, public-profile visibility and optional nearby discovery. This guide separates settings stored on the device from choices saved to CloudKit, so you know what changes and where.

HxAR 2.0 development previewAbout 8 minutes
HxAR 2.0 development guide.The interface and behaviour shown here may change. HxAR 1.2 remains the current App Store release.
HxAR 2.0 development Settings screen showing Colour and Display options and a Public Profile setting for HxElectrum visibility.
The development Settings screen groups appearance controls with public-profile choices. In this captured account, Show Tokens Publicly is off; final controls and account states may change before HxAR 2.0 is released.

What this guide achieves

Open Settings, make the interface comfortable to read, choose whether HxElectrum appears on the public profile and understand the permissions used by Nearby Collectables.

Topic
04
Starting point
Blue gear-shaped Settings control on the HxAR dashboard
Guide time
About 8 minutes
Screen status
HxAR 2.0 preview
Follow the steps

Quick walkthrough

Personalise HxAR in seven steps.

Start with the blue dashboard gear, adjust only the controls you understand, and confirm cloud or permission changes before leaving the screen.

  1. 01

    Open Settings from the dashboard

    Tap the blue gear at the upper right of the signed-in HxAR dashboard. It opens a standard scrollable Settings screen rather than an AR card.

  2. 02

    Check what will be stored

    Appearance sliders and Nearby Collectables are device-based choices. Public-profile visibility saves through CloudKit, while a selected custom glow colour is stored locally and also submitted as the profile’s tile colour.

  3. 03

    Open Colour & Display

    Select the pink Colour & Display card to adjust background contrast, glow brightness, custom glow colour and hex-line thickness.

  4. 04

    Use the preview to protect readability

    Make small changes and check the live hex-grid preview. Return to the dashboard and reduce extreme settings if text, controls or grid lines become difficult to distinguish.

  5. 05

    Choose public HxElectrum visibility

    Use Show Tokens Publicly only after reading its status. In the current development source, the public Tokens screen displays HxElectrum—not every Hx Vault balance.

  6. 06

    Configure Nearby Collectables if wanted

    Scroll below Appearance, review the explanation, then choose whether to enable low-power background discovery. Always Location controls closed-app detection; notification permission separately controls Lock Screen alerts.

  7. 07

    Confirm, troubleshoot or go back

    Wait for a successful CloudKit save, check each permission row, and use the back control to return. If an error remains, reopen Settings or follow the support guidance below.

Open Settings with the blue dashboard gear

The blue gear is the first control to the right of the HxAR title on the signed-in dashboard. It opens a conventional Settings page with a back control, so you can scroll and read without placing another panel in the camera view.

The screenshot shows only the first viewport. It contains the control-centre summary, Colour & Display and the beginning of Public Profile Settings. Scroll down for the rest of the public-profile card and the Nearby Collectables section.

The Adaptive iPhone + iPad label describes a layout that rearranges for the available screen width. It does not mean every preference automatically follows the account to another device.

Understand what stays on the device and what uses CloudKit

The Cloud synced · Public profile badge refers to account-facing profile information, not the complete Settings page. HxAR currently uses different storage for different choices.

Changing a device-based preference on an iPhone does not promise that an iPad will match it. Apple permission choices are also managed separately on each device.

Stored on this device

Background contrast, glow brightness, hex-line thickness and the Nearby Collectables enabled switch use device storage. The discovery switch is not a CloudKit profile preference; signing out stops monitoring but does not clear the saved choice on that device.

Local and profile colour

A custom glow colour is kept on the device and, when the account is available, HxAR also submits that colour as the profile’s tile colour, which can be used as a public profile or owned-tile accent. Clear Custom Color removes the local custom choice in this build; it should not be treated as confirmation that a previously saved profile colour was removed.

Saved to the public-profile record

Show Tokens Publicly loads from and saves to the signed-in user’s CloudKit profile record. A connection and successful save are required.

Controlled by Apple Settings

Location and notification authorisation belong to iOS or iPadOS. Turning a HxAR feature off does not itself revoke permission already granted to the app.

Adjust Colour & Display without making HxAR harder to read

Select Open appearance controls to enter Colour Settings. The controls update the hex-grid preview as you adjust them, and the device remembers the selected values.

There is no single Reset All button in the development screen. Clear Custom Color affects the custom colour only, so change the other sliders manually if you want a more neutral appearance.

Background Contrast

Moves between a whiter and darker hex-grid background. The label reports Whiteness below the neutral point and Darkness at or above it.

Glow Brightness

Changes the intensity of the hex-grid glow from a restrained setting to a much brighter effect.

Glow Color

Opens Apple’s colour picker for a custom glow. Use Clear Custom Color to remove the local custom selection.

Line Thickness

Changes the visual weight of the hexagonal grid lines.

Preview

Shows the combined background, glow and line choices. It is a sample grid, so also check the dashboard and a normal content screen before keeping an extreme combination.

Choose appearance settings you can read comfortably

Start near the existing values and adjust one control at a time. If grid lines disappear, increase line thickness or glow gently. If a bright glow competes with labels and controls, reduce brightness or choose a less intense colour.

Colour should not be the only way you identify a control. Read its label and switch status, and keep enough contrast between the grid, cards and text. The website repeats the controls in readable HTML because the supplied phone screenshot is only 295 pixels wide.

The HxAR 2.0 interface is still under accessibility review. In the source reviewed for this guide, the Colour Settings sliders do not yet have dedicated accessibility labels. A responsive layout and native controls do not by themselves prove that every combination meets a contrast target or that every screen is fully accessible.

Control whether HxElectrum appears on the public profile

Public Profile Settings first loads the account’s CloudKit preference. While it is loading or saving, the switch is unavailable. The off switch in the screenshot belongs to the captured development account and is not evidence of a universal default.

When Show Tokens Publicly is off, another person opening the profile’s Tokens area receives a private notice. When it is on, the current public Tokens view loads and displays the account’s HxElectrum balance. Despite the plural label, the reviewed source does not expose every Hexagon Token, Ore or Hx Vault figure or the account’s transaction history through that screen.

After changing the switch, look for the brief Public profile preference saved message. If it disappears before you can confirm it, or an error appears, reopen Settings and check the saved switch state rather than assuming the change reached CloudKit.

Nearby Collectables is optional and uses two permissions

Scroll below Appearance to Detect Collectables Nearby. Turning the switch on first shows an explanation; choose Not Now to leave it unchanged, or Enable Nearby Collectables to begin Apple’s permission flow.

Always Location allows Apple’s significant-location service to wake HxAR after meaningful movement when the app is closed. Notification permission separately allows a Lock Screen alert. One permission does not replace the other, and the screen reports Background location, Lock-screen notifications and Pocket detection separately.

HxAR uses a recent device location to determine a roughly 400-metre discovery cell and broad area. The current offer record stores that coarse cell identifier and area name rather than adding exact coordinates to the offer or collectable. The cell still represents an approximate area and should be treated as location data. This does not mean the app never accesses device location: location is needed to determine the cell.

Crossing into another broad cell does not guarantee a collectable. An active campaign, eligibility, availability and the development encounter rules still apply. Turning the feature off stops HxAR’s monitoring, but it does not revoke permissions or delete previous offers, collected items, notification records or local discovery history.

Troubleshoot loading, saving and permission states

If Public Profile Settings does not load, confirm that HxAR is signed in, iCloud is available and the device is online. A missing profile record or CloudKit error leaves the switch unavailable.

If Nearby Collectables shows Finish Permission Setup, use it to open the HxAR page in Apple Settings. Choose the location and notification permissions you want, then return to HxAR and check the three status rows again. Pocket detection needs the feature enabled, background monitoring available and Always Location permission.

An account recognised as an administrator may also see Admin Services in this development screen. Those publishing and management tools are excluded from this public-user guide; their absence on a normal account is expected and does not mean Settings failed to load.

Guide path

Move through HxAR one topic at a time.

New topics will be linked back into earlier guides whenever one action leads naturally to another.