โ Back to app
Everything you need to know about using JokeVault.
JokeVault is a private notebook for stand-up comedians. Write bits, track their development from raw idea to stage-ready material, and build set lists โ all synced to your account across any device.
Tap Create Account on the login screen. Enter your email and a password of at least 8 characters. Your account is created immediately.
Enter your email and password and tap Sign In. Your jokes, sets, and tags load from the server automatically.
Tap Forgot password? on the login screen. Enter your email and we'll send a reset link valid for one hour. Set your new password and you'll be returned to the sign in screen.
JokeVault is a Progressive Web App. In Safari, tap the Share button and choose Add to Home Screen. On Android, tap the browser menu and choose Install App.
Tap Clear (below the text area) to reset the title and body without saving. If you have unsaved text you'll be asked to confirm first.
Every bit has a development status. Tap a status button to set it before saving.
Tags categorise material by type. Tap any tag chip to toggle it. To create a custom tag, tap + Custom. A sheet slides up to type your tag name. Custom tags persist across sessions and can be renamed or deleted from the tag manager.
Open a bit from the Vault and tap Edit. It loads into the Capture tab. Saving returns you to the Vault with a โ confirmation. Navigating away with unsaved changes will prompt you to confirm.
The Vault is your full library. Every saved bit appears as a card showing title, status, preview, tags, and estimated duration.
Use the search bar to filter by title or body text. The status pills below filter by development stage.
Use the sort controls to order your vault by Newest, Oldest, AโZ, or Status. Newest is the default.
A scrollable row of tag pills appears below the sort controls. Tap any tag to filter. Multiple tags can be selected โ only bits matching all selected tags are shown.
Each card shows an estimated duration calculated at approximately 55 words per minute to account for pauses and delivery. Tap the duration pill to override it manually in steps of 0.5 min. Overrides carry over to set lists.
```Tap any card to open the detail view, which shows the full text, status, date saved, tags, and which set lists the bit belongs to. Tap a set name to jump directly to that set.
Tap + New and enter a name. The set is created immediately and becomes the active set.
Tap the set name dropdown at the top of the screen to open the set picker. Tap any set to switch to it.
Long-press the set name dropdown to edit it inline. Press Enter or tap away to save.
Tap + Add a bit at the top of the list. A picker sheet slides up showing your vault. Tap any bit to add it. Already-added bits are greyed out.
Tap the title or status of any bit in the set list to open its full detail view. Tap โ Back to return to the set.
Grab the โ ฟ handle on the left of any bit and drag to reorder. The order saves automatically.
Every time you edit and save a bit, the previous version is automatically stored. JokeVault keeps up to 10 versions per bit.
Open any bit's detail view and tap History in the top right. A sheet slides up showing previous versions with their date and status.
Tap a version to preview it. If you want to restore it, confirm the prompt and it loads into the Capture tab. Your current version is saved first before the restore, so nothing is lost.
Tap โฐ from any screen and choose Export to open the Export screen.
Set export options are greyed out if no active set has bits.
The Shows tab is a performance log for tracking every set you perform. Over time it gives you a clear picture of how your shows are trending.
Tap + Log a Show and fill in the date, venue, which set you performed, a star rating (1โ5), and optional notes. Tap Save Show to log it.
When you log a show, JokeVault saves a snapshot of the bits in your set at that exact moment. If you later rearrange or rewrite your set, the show log still reflects what you actually performed that night.
Once you have shows logged, a stats bar appears showing your total shows, average rating, and best rating. Filter by All time, 30 days, 90 days, or This year to see how a period of shows went.
Stage View shows your full set list as large white text on a black screen โ designed to be glanced at backstage before or during a show.
On the Sets tab, tap the โถ StageView button in the top right. Your set list titles appear numbered in large type. The screen stays on automatically so it won't dim while you're on stage.
A stopwatch sits at the top of Stage View. Tap it to start, tap again to pause, and hold to reset. The timer turns green while running.
Tap โ Close at the bottom right of the screen to exit. The stopwatch resets automatically when you close Stage View.
Tap โฐ from any screen and choose Send Feedback to open the feedback form.
Use this if something isn't working as expected. Describe what happened, what you were doing, and what you expected to see.
Use this to suggest something new. Describe the feature and why it would help your workflow.
Tap โฐ from any screen and choose Account. It shows your email address and the date you joined.
From the Account screen, tap Change Password. Enter your current password and choose a new one (minimum 8 characters).
From the Account screen, tap Sign Out. Your data stays safely on the server.
From the Account screen, tap Delete Account. You'll be asked to confirm your password. This permanently deletes all your bits, sets, tags, and account data and cannot be undone.
JokeVault requires an internet connection to load and sync data. If you lose connection, saves and edits will fail until you're back online.