BUILT INTO EVERY GOODSPEED APP
Soft Paywall (Usage Gates)
A usePaywall hook wraps any feature with a usage limit check that transparently redirects non-paying users to the paywall modal without requiring the feature code to know anything about subscription state.
- Tier: Common
- Status: Config-toggled
- Config: features.inAppPurchases.enabled
WHY IT MATTERS
Most mobile app projects spend weeks plumbing the same infrastructure before writing a single line of product code. Soft Paywall (Usage Gates) is one of those cross-cutting concerns that every app eventually needs but almost none get right the first time. Permissions are handled incorrectly, tokens expire silently, or the feature breaks after an OS update nobody tested against.
Goodspeed solves this by shipping soft paywall (usage gates) as a production-grade, tested implementation inside every generated app. The code follows the patterns in the GAS template - the same 246-feature catalog that powers every app we build. Controlled by `features.inAppPurchases.enabled` in gas.config.ts. You own the code from day one, can read every line, and can hire any React Native developer to extend it. The build pipeline verifies the feature compiles and routes resolve before the app lands in your repository, so you are not the one catching the integration error at 2 am before launch.
HOW IT IS WIRED
Real code from the GAS template
The excerpt below is lifted verbatim from gas.config.ts in the gas-template repository. This is the code your generated app gets, not pseudocode, not a description of intent.
// Enable this feature in gas.config.ts
export const gasConfig = {
features: {
// Set the relevant flag to true to enable
},
};Source: goodspeed-apps/gas-template → gas.config.ts
HONEST LIMITS
When Soft Paywall (Usage Gates) is the wrong choice
Not suitable for apps where any access at all requires payment before the first screen. Use a hard paywall (full screen block) in that case. Also avoid this pattern for B2B apps where billing happens outside the mobile stores, or where entitlements are managed server-side by a separate access-control system that cannot be reduced to a single tier string.
Tier: Common · Config-toggled
Evaluate your use case
Check whether soft paywall (usage gates) aligns with your target audience, platform constraints, and regulatory environment before enabling it.
Audit the config
The `features.inAppPurchases.enabled` flag controls this feature. Set it to false in gas.config.ts to disable the feature entirely with no residual code paths.
Seek alternatives
If the built-in implementation does not fit, the generated codebase is standard React Native + Expo code. Any library in the Expo ecosystem can replace the default.
APPS USING THIS FEATURE
Every generated Goodspeed app includes soft paywall (usage gates). Browse the ideas catalog to see apps across all categories that ship with this feature wired in.
CAPABILITIES
Soft Paywall (Usage Gates) capability breakdown
Concrete dimensions of what the built-in soft paywall (usage gates) implementation covers. These reflect the actual template code, not a marketing summary.
| Item | Description | Strength |
|---|---|---|
| Storage backend | Data for this feature is managed by Supabase (profiles.subscription_tier). | Supabase (profiles.subscription_tier) |
| Network mode | This feature operates in Online-only mode. | Online-only |
| Sync frequency | Data syncs On-demand. | On-demand |
| Tier | Common feature — config-toggled. | Common |
| Template status | Enabled via features.inAppPurchases.enabled. | Config-toggled |
GET IT BUILT INTO YOUR APP