Support

PocketStash for ByteStash is a native, local-first ByteStash client for iPhone and iPad.

If something is not working, or if you have a question, email us and we will take a look.

Contact

Email: [email protected]

We aim to respond within a few business days. Please include your iOS version, your device, your PocketStash version, your ByteStash version if you know it, and what you were doing when the issue happened. You can attach the app’s diagnostics with Share Diagnostics in Settings; they leave out server addresses, server names and API keys. Never send us an API key.

Common questions

Do I need a ByteStash server?

Yes. PocketStash is a client for ByteStash, a separate, open-source, self-hosted snippet manager. The server is not included with the app, and PocketStash is not affiliated with the ByteStash project.

The app can’t connect to my server.

PocketStash requires an https:// server address. Check that the address is the server’s base URL, that you can open it in Safari on the same device, and that the API key is correct. Servers with accounts turned off can be added with an empty key. Use Test Connection before saving.

What does “saved on this device” mean?

PocketStash saves every change on your device first, then synchronizes it with the right server when a connection is available. The pending status shows what still needs to sync; tap it to inspect pending work or retry recoverable failures.

What happens when there’s a conflict?

If a snippet changed both in PocketStash and on the server, you choose which version to keep. The other version is saved as a recovery copy, so unsynchronized changes are never silently discarded.

What is “Upload needs review”?

If the connection dropped while a new snippet was uploading, PocketStash can’t always tell whether the server received it. Check the server for the snippet before uploading it again, so you don’t end up with a duplicate.

Can I use more than one server?

Yes. Each server keeps its own credentials, cache, synchronization queue and conflicts, and switching servers never sends pending work to the wrong one.

Do my snippets sync through iCloud?

No. Snippets sync only with your ByteStash servers. iCloud, when enabled, carries only appearance, line-number, line-wrapping and sort preferences.

How do suggestions work?

In Settings → AI Features, choose Apple Intelligence (on device, on supported devices) or PocketStash Cloud. PocketStash Cloud is off until you agree on its consent screen; after that, the code of the file you ask about is sent to PocketStash’s server, only when you tap Suggest or Explain. See the Privacy Policy for details.

PocketStash Cloud says it isn’t available.

PocketStash Cloud has a monthly allowance per installation and needs a connection. If it is unavailable, you can switch back to Apple Intelligence in Settings → AI Features on supported devices.

How do I remove my data?

Remove a server in the app to delete its key and local workspace from your device, or delete the app to remove everything it stores locally. Snippets on your ByteStash server are not affected.

Feature requests & bug reports

For bugs, tell us what you tapped, what happened, and what you expected to happen. Please don’t include private code or API keys in screenshots.