Project Slots and Plans

This page explains the project slots available to you, how to purchase extra slots, and how to apply and deactivate a license.

Overview

GalleonQL lets you create multiple projects in a single app, but there is a limit on how many projects you can keep at once, expressed as slots. One slot is available for free, and you can add more by purchasing extra slots as needed. Applying a license adds slots; deactivating it reverts them. The app also verifies your license online each time it starts, so if you cancel or your subscription lapses, your slots automatically return to free once your paid period ends (see "License check at startup (applying subscription changes)" below).

Payment goes through Lemon Squeezy (online payment by credit card, etc.).

Prerequisites

• The app is running per Getting started / installing and launching.
• You have already created at least one project, or are about to create one.

What project slots are

Your total slots are "1 free slot + purchased extra slots."

When you open the project selector menu in the top bar, a one-line summary reading "{used} / {limit} slots used" appears right below the "Select project" heading. You can also check the same usage in the License section of Settings (⚙) and in the plan management screen described below (the numbers match everywhere).

Right below this summary, one of the following notices may appear depending on your slot situation (if neither applies, nothing is shown).

Beyond-slot projects (can't be selected, but not deleted)

Among your saved projects, in creation order the first ones up to your slot count are "within slots," and any beyond that are beyond slots. This can happen when your slots decrease — for example, when you deactivate an extra-slot license or cancel your subscription.

For a beyond-slot project, only "selecting and using it" is restricted; you can edit, organize, and rescue its data at any time. Data is never lost.

• In the project selector menu, a beyond-slot row is grayed out and gets a "Locked" badge on the right. Hovering over the row shows why it can't be selected (data is kept and can be exported).
• Edit (✎) can still be pressed when beyond slots. In the drawer that opens, you can edit the name, color, shared variables, and shared headers, or delete the project via "Delete." However, closing the drawer does not make that project selected (the first within-slot project stays selected). Think of it as "you can organize and delete, but you can't select and use it."
• If the currently selected project falls beyond slots (for example, right after canceling), the app automatically switches the selection to the first project in order (which is always within slots). No manual action is needed.
• For how to export a beyond-slot project, see Exporting / importing a project.

Managing your plan

All plan operations (purchasing extra slots, applying a license key, and canceling) are consolidated into a single plan management screen. You can open it from any of the following:

• Open the project selector menu and press "Add slots" in the footer.
• Open Settings (⚙) and press "Buy more slots" (when not registered) or "License info" → "Manage plan" (when already registered).
• When you try to create a new project but don't have enough slots, this screen opens automatically (shown with the heading "Project slot limit reached").

The plan management screen shows your current usage (free slots, extra slots, total limit), a quantity selector and estimated price for additional purchases, and a field to apply a license key. Because pricing is fetched online, you can't purchase without a network connection (when pricing can't be fetched, the purchase button is disabled).

Buying extra slots

1. On the plan management screen, choose the number of slots under "Slots to add" (1–20 slots).
2. A breakdown for the chosen quantity (count, unit price, subtotal, monthly total) is shown in a table.
3. Press the "Buy {n} slots (+¥{amount})" button to open the Lemon Squeezy purchase page in your default browser.
4. Once you complete payment in the browser, the license key is shown in an email or on the Lemon Squeezy screen.

Applying a license key

The "License key" field is not shown if you already have a license applied and haven't started a new purchase yet (once applied, you don't need to re-enter it until your next purchase). The steps below assume the field is shown (when unlicensed, or right after opening the purchase page).

1. Enter the key you received after purchase into the "License key" field on the plan management screen.
2. Press the "Apply" button.
3. On success, a "Registration complete" screen appears and shows your new post-purchase limit.
   • If it opened due to insufficient slots while creating a project, the "Continue" button takes you back to creating the project.
   • If it opened from the project selector menu or Settings, close it with the "Close" button.
4. If the key is invalid, expired, not activated, and so on, an error message is shown and your slots don't change.

Deactivating a license vs. canceling a subscription (don't confuse the two)

The plan management screen shows a "Manage license / subscription" section only when you opened it from "Add slots" in the project selector menu or "Manage plan" in Settings, and an extra-slot license is already registered. It contains two operations with different purposes. Mixing them up leads to unintended results, so be sure to tell them apart.

In other words, use "Cancel subscription" when you want to stop billing. After you cancel, your slots automatically return to free at the next app startup once your paid period ends. If you want to return this device's slots to the free equivalent right now, without waiting for the period to end, use "Deactivate license on this device" (this returns you to the free slot immediately).

"Deactivate license on this device"

Because this is a destructive action, pressing it shows a confirmation dialog. Pressing "Deactivate" confirms it, and this device's extra slots go to 0 (back to the single free slot). If you use the same key on other devices, they are unaffected.

• During deactivation, if possible, this device's activation on the Lemon Squeezy side is also released. This lets you use the same license key again on another machine.
• If the Lemon Squeezy side fails to release (e.g. no network), your license on this device is kept and an error message is shown. The confirmation dialog stays open, so you can check your network and press "Deactivate" again to retry.
• Pressing "Deactivate" first switches to a "License deactivated" completion screen, which shows your post-deactivation slot situation (whether everything fits within the free slot, or whether some projects are now beyond slots). Review it and press "Close" to close the screen.
• If the device registration information is missing — for example when the key was applied with an older version of the app — the automatic release on the Lemon Squeezy side is not performed, and the completion screen adds a note asking you to release the device registration manually from the billing page in your purchase email.

"Cancel subscription (stop billing)"

Pressing this opens your Lemon Squeezy billing page (the URL in your purchase email) in the browser. You perform the actual cancellation on that page. Even after you cancel, you can keep using your extra slots for the rest of your paid period. Once that period ends, at the next app startup your slots automatically return to the free slot (1 slot) and the license key is removed from this device (see "License check at startup (applying subscription changes)" below for how this works). If you want to return to the free slot right now, without waiting for the period to end, do "Deactivate license on this device" above.

License check at startup (applying subscription changes)

When you have an extra-slot license registered, GalleonQL checks the validity of your license over the internet every time the app starts. This automatically applies to the app, at the next startup, any state where you have canceled your subscription or your license has lapsed because payment stopped.

• When valid (subscription active, or canceled but still within the paid period): your extra slots are kept as-is.
• When lapsed (expired, revoked, canceled and past the paid period, or the key became invalid): your extra slots automatically return to the free slot (1 slot), and the license key is removed from this device. Projects beyond your slots become beyond-slot (can't be selected, but data is kept); no data is ever deleted.
• When you can't connect to the internet (starting offline): a license that was valid until just before is temporarily kept as long as it is within 24 hours of the last successful online check and still within its validity period. During this time a "Cannot verify license" notice is shown, but you can keep using the app. If more than 24 hours have passed, the validity period has expired, or the device clock has been turned back, you return to the free slot and the license key is removed. The next time you start online, if the license is still valid, your extra slots are automatically restored.

This check runs only when you have an extra-slot license key registered (it does not run when you use only the free slot). The final judgment of validity rests on the online check; being temporarily kept while offline is only a short grace period, not permanent.

Troubleshooting

Related documents

• Basics of projects and environments: Registering and switching environments (connection profiles)
• Export that works even beyond slots: Exporting / importing a project
• Term definitions: Key terms
• Manual index: GalleonQL User Manual