Home Screen Help

Overview

The Home screen (member.unlockos.io/{facility-slug}) is the main screen after logging in. It shows your current membership information, remaining usage quota, and the list of facility spaces available for check-in. If you have multiple active subscriptions, a header and quota block are shown for each one. Tap a SpaceCard to start a check-in session. While checked in, the session panel displays the elapsed time and your entry key.


Detailed Features

Feature 1: Pending Payment Banner

If your membership application has been approved by the facility but payment has not yet been completed, a banner appears at the very top of the screen (above the session panel and membership header).

Item Description
Title "Your membership application has been approved"
Message The approved plan name, with a prompt to complete payment
Button Proceed to payment — resumes the signup payment flow

This banner can appear even if you already have another active subscription (for example, when you have applied for a second plan). If multiple applications are awaiting payment, a banner is shown for each one.

Once payment is completed, the banner disappears and the new subscription becomes active.

Feature 2: Membership Header

The header below any pending-payment banners shows your current plan details.

Item Description
Plan Name The name of your active membership plan
Valid Until The end date of your current billing period (e.g., ~ 2026/06/01)

If you have multiple active subscriptions, a separate header block is shown for each one so no subscription is ever hidden.

If you do not have an active membership, a "No membership" message is shown along with available plans for the facility. Tap a plan to be taken to the signup page.

Feature 3: Quota Bar (Usage Progress)

If your membership plan has usage limits (quotas), your current usage is displayed as progress bars. Units are shown in the app's current language (e.g., "回" for check-in counts, "時間" for hours in Japanese).

Quota Type Description
Monthly check-ins Check-ins used / limit for this month
Daily hours Cumulative usage hours today / daily limit
Monthly bookings Time slot bookings used / limit for this month

This section is hidden if your plan has no quota limits. If you have multiple active subscriptions, a quota block is shown for each one directly below its membership header.

Overage behavior: If the overage policy is "block," check-in is rejected once the limit is reached. If the policy is "charge," overages are billed separately (a note is shown on screen).

Feature 3.5: Reservation Plan Section

If your membership plan is linked to a reservation (booking) plan, a Reservation plan section appears on the Home screen.

Each card shows:

  • A representative image for the plan (facility photos, or an auto-generated illustration if none are set)
  • The reservation plan name
  • The facility name
  • Open Reservation Plan button

Tapping the button opens the Booking app with that plan pre-selected.

This section is hidden when your membership plan has no associated reservation plan.

Feature 4: Space List (SpaceCard)

The spaces associated with your membership plan are shown as a card grid.

Each card displays:

  • Space image (facility photos, or an auto-generated illustration if no photos are set)
  • Space name
  • Linked plan name
  • Remaining quota (shown only when a limit applies)
  • Check in here button

If multiple photos are set, swipe left or right to browse them. Tapping a real photo opens a lightbox view.

Feature 5: Checking In

Tap the Check in here button on a SpaceCard to start a check-in session.

During check-in processing

  • The button is disabled while processing
  • After a successful check-in, your entry key (QR code) is automatically shown in a popup
  • The session panel appears at the top of the screen and a timer starts

Session Panel while checked in

Item Description
In Use Green indicator showing you are currently checked in
Check-in time When you checked in and which space
Elapsed time A real-time counter
Show QR button Re-opens the entry key modal
Check Out button Opens the checkout confirmation dialog

Feature 6: Entry Key Display

After checking in, or any time you tap Show QR, the entry key modal appears.

Key Type Description
QR Code Hold your phone in front of the smart lock reader to unlock
PIN Code Enter the digits on a keypad to unlock
Remote Unlock Tap the button in the app to unlock remotely (supported facilities only)

Keys have an expiry time. The key is refreshed automatically when it is close to expiry. You can also tap the refresh button manually.

Feature 7: Checking Out

Tap the Check Out button to open a confirmation dialog.

  1. Tap Check Out to confirm
  2. After checkout is complete, an exit QR key may be displayed
  3. The session panel disappears and you return to the Home screen

Note: Checkout cannot be undone. Please confirm before proceeding.


Frequently Asked Questions

Q: A "Your membership application has been approved" banner is shown

Your application has been approved by the facility, but payment is not yet complete. Tap Proceed to payment to complete the signup flow. Until payment is completed, the subscription is not active and the banner will remain.

Q: No spaces are shown

Your membership plan may not be linked to any facility entrance configurations. Please contact the facility.

Q: The Check in button does not respond

If you are already checked in, you cannot start another session. Check out first.

Q: My quota has reached 0 and I cannot check in

You have used all your check-ins for this month. The quota resets at the start of the next billing period. Contact the facility if you need a quota increase.

Q: The QR key is not showing

Check your network connection. If the connection is fine, reload the page and tap Show QR again.


Troubleshooting

Check-in is stuck on "Processing"

Reload the page. In some cases your session will be restored automatically. If the issue persists, contact the facility.

An "In Use" session appears when you open the page

If you closed the app without checking out in a previous session, the session may still be active. Tap Check Out to end it properly.