Configuration

Properties

appName

string

required

The name of your application.Example: 'LaunchIt'

appUrl

string

required

The URL of your application.Example: process.env.NEXT_PUBLIC_SITE_URL ?? ''

appDescription

string

required

The description of your application. This uses a translation key.Example: 'config.appDescription'

supportEmail

string

required

The email address for support inquiries.Example: '[email protected]'

marketingEmail

string

required

The email address for marketing communications.Example: '[email protected]'

twitterHandle

string

The Twitter handle for your application.Example: '@yourhandle'

onboadingActive

boolean

required

If you wish to display an onboarding page after the user signs up, you can enable it here. This will per default ask the user for his first name and last name.Example: true

blogFolder

string

required

The folder containing your blog content files.Example: 'web/content/blog'

i18n

I18nConfig

required

Internationalization (i18n) configurations.

Show I18nConfig

enableLangRouting

boolean

required

Enable or disable the language routing and switching via prefix e.g. /en.Example: true

defaultLocale

string

required

The default language for your application.Example: 'en'

Authentication configurations. LaunchIt supports multiple authentication methods that can be enabled or disabled based on your needs.

Show LoginConfig

Magic link/password login will still work - this hides the login button, and disables signups. This is useful for beta testing. If you want to disable logging in completely, open web/app/[locale]/(unprotected)/signin/page.tsx and remove the file or return a 404.Example: true

Enable traditional email/password login.Example: true

Enable passwordless login via email links.Example: true

Set the default login method.Example: 'magic_link'

Toogle if the user needs to be logged in to make a purchase.Example: true

privacyPolicyUrl

string

required

The URL for the privacy policy. Necessary for legal compliance (Cookie consent banner) and footer.Example: '/privacy'

tosUrl

string

required

The URL for the terms of service. Necessary for legal compliance (Cookie consent banner) and footer.Example: '/tos'

Cookie consent banner configurations.

Show CookieBannerConfig

enabled

boolean

required

Enable or disable the cookie consent banner. If disabled, the banner will not be displayed and every service will be loaded by default.Example: true

services

ServicesConfig

required

Additional service configurations.

Show ServicesConfig

posthog

boolean

required

Enable or disable Posthog analytics.Example: true

plausible

boolean

required

Enable or disable Plausible analytics.Example: true

googleAnalytics

boolean

required

Enable or disable Google Analytics.Example: false

pricing

PricingConfig

required

Pricing configurations. LaunchIt supports both subscription and one-time purchase models. The pricing configuration is one of the most complex parts of the setup.

Show PricingConfig

defaultModel

'subscription' | 'one-time'

required

Set the default pricing model that is displayed by the <Pricing /> component.Example: 'subscription'

freeProduct

FreeProduct

required

Free tier configuration. If you want to display a free tier, you can configure it here. It will automatically redirect to the sign-in page.

Show FreeProduct

name

string

required

The name of the free product.Example: 'config.pricing.free.title'

description

string

required

The description of the free product.Example: 'config.pricing.free.description'

features

ProductFeature[]

required

An array of features included in the free tier.Example: [ { name: 'config.pricing.features.core1' }, { name: 'config.pricing.features.core2' } ]

notIncluded

ProductFeature[]

An array of features explicitly not included.

initialCredits

number

The number of credits new users receive.Example: 3

enabled

boolean

required

Toggle the free tier.Example: false

highlight

boolean

Whether to highlight this product in the UI.

subscriptions

SubscriptionProduct[]

required

Array of subscription product configurations.

Show SubscriptionProduct

name

string

required

The name of the subscription.Example: 'config.pricing.subscriptions.basic.name'

level

number

required

The hierarchy level of the plan.Example: 1

description

string

required

The description of the subscription.Example: 'config.pricing.subscriptions.basic.description'

features

ProductFeature[]

required

An array of features included in the subscription.

notIncluded

ProductFeature[]

An array of features explicitly not included.

monthly

PriceInfo

required

Monthly pricing configuration.

Show PriceInfo

priceId

string

required

The Stripe price ID for the monthly plan.Example: process.env.NEXT_PUBLIC_STRIPE_STARTER_MONTHLY_PRICE_ID ?? ''

price

number

required

The monthly price.Example: 9.99

priceAnchor

number

The anchor price to show discount.Example: 14.99

annually

PriceInfo

required

Annual pricing configuration.

monthlyCredits

number

The number of credits awarded each month.Example: 100

promotion

PromotionCode

Promotion configuration for the subscription.

Show PromotionCode

code

string

required

The promotion code for customers. Displayed on the pricing card.Example: 'LAUNCH70'

percentage

number

required

The discount percentage. Needed for showing the discount badge.Example: 70

stripe_id

string

required

The corresponding Stripe promotion ID. Needed for automatic application.Example: 'promo_1QWMbOCVjR3erEYezwWi7faL'

autoApply

boolean

required

Whether to automatically apply the promotion in stripe. (Note: This will force users to use the promotion code. They cannot remove it or use another code.)Example: false

showBadge

boolean

required

Whether to show the promotion badge on the pricing card.Example: false

highlight

boolean

Whether to highlight this plan in the UI.Example: false

oneTimePurchases

OneTimePurchaseProduct[]

required

Array of one-time purchase configurations.

Show OneTimePurchaseProduct

name

string

required

The name of the one-time purchase.Example: 'config.pricing.oneTime.starter.name'

level

number

required

The hierarchy level of the purchase.Example: 1

description

string

required

The description of the one-time purchase.Example: 'config.pricing.oneTime.starter.description'

features

ProductFeature[]

required

An array of features included in the purchase.

notIncluded

ProductFeature[]

An array of features explicitly not included.

price

PriceInfo

required

Pricing configuration for the one-time purchase.

totalCredits

number

The total credits included with the purchase.Example: 100

validityPeriod

'lifetime' | `${number}-months`

required

The validity period of the purchase.Example: 'lifetime'

promotion

PromotionCode

Promotion configuration for the purchase.

highlight

boolean

Whether to highlight this purchase in the UI.Example: false

Navigation configurations.

Show NavigationConfig

isSticky

boolean

required

Whether the navigation bar is sticky.Example: true

oAuth Providers

oAuthProviders

OAuthProvider[]

required

Array of OAuth provider configurations. See List of supported OAuth Providers.This will be automatically used in the <OAuthSignIn /> component on the sign-in page.

Show OAuthProvider

name

Provider

required

The name of the OAuth provider.Example: 'github'

displayName

string

required

The display name for the provider.Example: 'GitHub'

icon

JSX.Element

required

The icon configuration for the provider.

Further Information

Validation Checks:

At least one authentication provider must be active (either password login, magic link login, or an OAuth provider).
The default login method must be active.

Get Started

Initial Setup

Customization

Utilities

Legal

Marketing & Analytics

SEO

Deployment

Properties

oAuth Providers

Further Information

Get Started

Initial Setup

Customization

Utilities

Legal

Marketing & Analytics

SEO

Deployment

​Properties

​oAuth Providers

​Further Information

Properties

oAuth Providers

Further Information