# Soulver Studio

### What is Soulver Studio?

Soulver Studio is a feature that turns your Soulver sheets into stand-alone apps that can be installed on any Mac running macOS 12+.

<figure><img src="/files/wjFqSad5N5zpra9eQqKG" alt="Soulver Studio icons" width="375"><figcaption><p>7 fruity icons to choose from for your cool new calculator app</p></figcaption></figure>

### Why would I want to do this?

* Use Soulver Studio to share a sheet of calculations (presumably with some variables and line references) with people who don't have Soulver installed.
* You might use it as an alternative to sending someone an Excel/Numbers spreadsheet, for example.

### How do I use it?

1. Select a sheet and then go to the **Sheet** menu > **Build app from Sheet**.
2. Provide some details about your new app: give it a memorable name, set the version number (1.2.3, etc) and provide a unique identifier that will stay constant across new builds of your app (an identifier is required by macOS for all Mac apps).
3. Choose your preferred icon from 1 of 7 colorful options available.
4. Click **Upload and Build**.
5. Your new app will be ready for download in (typically) less than 5 minutes. It will be around 7 MB zipped, and 15 MB unzipped.

<figure><img src="/files/yicouWbwoNeEmrqDXb2p" alt="Soulver Studio setup screen" width="563"><figcaption><p>It really is this easy to turn a Soulver sheet into a stand-alone app.</p></figcaption></figure>

### What happens after my sheet is uploaded?

* After your sheet is uploaded to our servers, it is turned into a Soulver-like Mac app.
* The app is then [sandboxed](https://developer.apple.com/documentation/security/app_sandbox/protecting_user_data_with_app_sandbox). Sandboxing is an optional security measure on macOS to makes apps technically unable to access your files (for extra peace-of-mind).
* The app is then dispatched to Apple's for a process called [notarization](https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution). This is a necessary step to make the app installable on other Macs (see [Gatekeeper](https://support.apple.com/guide/security/gatekeeper-and-runtime-protection-sec5599b66df/web)). It typically takes a few minutes, but can take up to an hour if Apple is having a busy day.
* Your app will be deleted from our servers within 24 hours of completion. If you want to share your app with others, you'll need to host it somewhere yourself.

### Limitations

* Soulver Studio apps cannot make new lines. We recommend you set up your sheets with variables & line references to make them useful as standalone apps.
* Soulver Studio apps cannot access live stock prices or do weather queries (but they do have access to live currency rates).
* We are limited by Apple to building [75 apps per day](https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution/customizing_the_notarization_workflow#3561440). When this limit is reached, Soulver Studio will be unavailable for some period of time.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.soulver.app/documentation/exporting/soulver-studio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
