Wean Nicotine

Reduce snus at your pace

Wean Nicotine is for people who would rather cut down on snus and nicotine pouches a little at a time than stop overnight. You pick a pace, and your daily allowance steps down each week, in whole pouches. One tap logs a pouch or a craving you let pass, and a day over the limit is simply logged, with no streak to break and nothing to make up. Progress counts the pouches you've avoided and, if you add a price, the money saved. Your log stays on your iPhone, with no account, until you export it yourself.

For developers

The developer half: what's in the app, how to build and run it, how it is put together, how to contribute, and the license.

What's in it

• Onboarding: your usual pouches a day, a pace from 3% to 15% a week with a preview of when the allowance reaches zero, an optional price per can, and the moments you usually reach for one.
• Today: the day's allowance as a whole number, one tap for Used a pouch or Resisted craving, a 10-second undo, and an optional tag for what set a pouch off.
• The plan: a weekly reduction at the pace you chose. Baseline, pace and price can change in Settings without losing the log. If you run well above the plan for two weeks, Today offers to ease the pace, and stays quiet for a week if you dismiss it.
• Progress: each week's daily bars, pouches avoided against your starting point, money saved, gentle milestones, and a Patterns card for the time of day and the triggers behind your pouches.
• Tools: guided breathing, an urge-surfing timer, reflection prompts with an optional journal, and a savings calculator.
• Settings: optional local reminders, a light or dark appearance, Export Data as a CSV file, Send Feedback, and Start Over.
• The end of the plan: when the allowance reaches zero, Today marks it once, around the plan rather than a count of days.

There are no accounts, no cloud sync, no streak counter and no medical advice, by design. Anonymous crash reports go to Sentry, as the privacy policy says. What's next is tracked in GitHub Issues, and CHANGELOG.md has the history.

Build and run

Prerequisites: Node 22 (.nvmrc), and Xcode for a development build.

npm install
npx expo start

Notifications need a development build, not Expo Go:

npx expo run:ios

npm run check runs lint, the type check and the tests, as CI does.

Sentry is optional. For development, copy .env.example to .env and set EXPO_PUBLIC_SENTRY_DSN; events are only logged to the console in development. Builds take the DSN from EAS environment variables, never from .env:

eas env:create --name EXPO_PUBLIC_SENTRY_DSN --value "https://[email protected]/xxx" --environment production --visibility plaintext

docs/SENTRY.md covers the setup and how to check it. No secrets are stored in the repo.

Releasing (iOS, bundle ID com.iamjarl.taper):

1. Raise ios.buildNumber in app.config.js above the last upload, and version for a new release.

2. Build in the cloud and upload to App Store Connect:

   eas build --profile production --platform ios --auto-submit
   

   Add --local and leave out --auto-submit to build on your Mac instead, then upload the IPA with Transporter. eas is the globally installed eas-cli (npm install -g eas-cli); npx eas does not work in this repo.

3. Tag the release commit (git tag -a vX.Y.Z -m "…") and push the tag. The Release workflow publishes the GitHub Release from that version's section of CHANGELOG.md.

The App Store screenshots are made as appstore/README.md describes.

How it is put together

Expo SDK 55 on React Native's New Architecture, Expo Router, SQLite through expo-sqlite for everything the app stores, local notifications, and Sentry for crash reports. There is no backend. The app is iPhone only; the web target only renders the UI for design previews.

app/
  (onboarding)/          # welcome, baseline, pace, price, triggers
  (tabs)/
    home.tsx             # Today
    progress.tsx         # Progress
    tools/               # breathing, urge surfing, reflection, journal, savings
    settings/            # settings, edit plan, notifications, start over
components/              # UI, with reusable primitives in ui/
hooks/                   # useHomeData, useAppInitialize, keep-awake
lib/                     # the domain logic
  db*.ts                 # SQLite and its migrations
  taper-plan.ts          # the taper maths
  progress.ts            # progress and milestones
  export-csv.ts          # Export Data
  notifications.ts       # local reminders
  design.ts, theme.ts    # IAMJARL design tokens
appstore/                # App Store screenshots and how they're made
website/                 # the Astro site at weannicotine.iamjarl.com
docs/                    # architecture, decisions, store metadata
scripts/                 # maintainer tools

Start with docs/README.md for the map of the docs and docs/ARCHITECTURE.md for the architecture. docs/decisions/storage.md explains why everything lives in SQLite on the phone. The code is the source of truth for exact behaviour.

Contributing

Issues and pull requests are welcome; CONTRIBUTING.md has the details, and SECURITY.md says how to report a vulnerability.

License

MIT © 2026 IAMJARL.