How to use PuffTab

PuffTab works best when you set up a few basics first. Once your library is in place, logging puffs becomes quick, consistent, and searchable.

Recommended setup order

PuffTab's core building blocks are connected:

• Shops are where you buy supplies.
• Brands (optionally linked to a Producer) are attached to supplies.
• Supplies are the products you have on hand (they track grams remaining).
• Puffs reference a supply and a method, and reduce grams remaining.

For the smoothest setup, add them in this order:

1. Create at least one Shop and one Brand.
2. (Optional) Create Producers and link them to brands.
3. Create or adjust your Methods (so default gram amounts are correct).
4. Add your first Supply (this requires selecting a shop and brand).
5. Start logging Puffs.

Add shops

More → Shops

1. Open PuffTab and tap More.
2. Tap Shops.
3. Tap Add Shop (bottom button).
4. Enter a name (and optionally location, address, rating, photo, and notes), then tap Save.

Add producers & brands

You can use brands on their own, or link them to a producer for better organization.

Producers

More → Producers

1. Tap Add Producer.
2. Enter a name (and optionally license number, website, headquarters, year founded, rating, and notes), then tap Save.

Brands

More → Brands

1. Tap Add Brand.
2. Enter a brand name.
3. (Optional) Set Licensed Producer to link the brand to a producer.
4. (Optional) Add a photo, rating, and notes.
5. Tap Save.

Set up methods

Methods tab

1. Tap Methods.
2. Tap Add Method and create the methods you actually use (for example: bong, joint, vape, pipe).
3. Set a Default grams value for each method. This makes logging faster and improves shortcut accuracy.
4. Reorder methods with Edit so your favorites are at the top.

Add supplies

Supplies tab

1. Tap Supplies.
2. Tap Add Supply (bottom button).
3. Fill out Basic Info: name, brand, shop, and variety.
4. Fill out Quantity & Cost: the grams you purchased and what you paid (cost-per-gram is calculated automatically).
5. (Optional) Add potency, terpenes, photos, dates, rating, and notes.
6. Tap Save.

Log puffs

You can add puffs from the Puffs tab or from the Supplies tab.

1. Tap Add Puff.
2. Set the date and time (defaults to "now").
3. Select a supply (only supplies with grams remaining are available).
4. Select a method and grams amount (the grams picker will include your method defaults).
5. (Optional) Mark the puff as shared or gifted, and add a photo or notes.
6. Tap Save. PuffTab deducts grams from your supply and updates your stats.

Siri & Shortcuts

PuffTab includes built-in shortcuts so you can log a puff (or check your status) without opening the app.

Available PuffTab shortcuts

• Smart Puff: logs a puff with smart/default selections.
• Interactive Log: prompts you to choose a supply and method (great for hands-free logging).
• Last Puff Time: asks "how long since my last puff?"

Add a Siri phrase (recommended)

1. Open Apple's Shortcuts app.
2. Create a new shortcut and tap Add Action.
3. Search for PuffTab and choose an action (for example: Smart Puff or Interactive Log).
4. Configure the action (pick a default supply/method if you want fewer prompts).
5. Open the shortcut's details and add a Siri Phrase (for example: "Puff Puff").
6. Try it: say "Hey Siri, Puff Puff".

Home screen widgets

PuffTab widgets keep you up to date at a glance:

• Last Puff: time since your last puff.
• Supply Tracker: remaining grams for your active supplies.
• Daily Limit: progress toward your daily gram target.

Add a PuffTab widget

1. On your iPhone's Home Screen, press and hold an empty area until icons jiggle.
2. Tap the + button in the top-left.
3. Search for PuffTab.
4. Select a widget (Last Puff, Supply Tracker, or Daily Limit), choose a size, then tap Add Widget.

Enable the Daily Limit widget

The Daily Limit widget requires enabling daily limits inside PuffTab:

1. Open PuffTab and go to More → Settings.
2. In Daily Limits, turn on Enable Daily Gram Limit.
3. Choose a daily target (for example: 1.0g, 2.0g), then return to your Home Screen.

Troubleshooting

"Add Puff" is missing or disabled

You need at least one active supply (a supply with grams remaining) before you can log a puff. Add a supply first, or mark a finished supply as active again.

Widgets show "No puffs yet" or "No active supplies"

• Log your first puff to populate the Last Puff widget.
• Add a supply (with grams remaining) to populate the Supply Tracker widget.
• If widgets look stale, open PuffTab once and give iOS a moment to refresh.

Shortcuts aren't appearing in the Shortcuts app

• Open PuffTab once, then try again.
• In Shortcuts, search for "PuffTab" under Apps.
• Restart the Shortcuts app if needed.