Frequently Asked Questions

Frequently asked questions about ignitionstack.pro.

General

What is ignitionstack.pro?

ignitionstack.pro is a complete boilerplate for building SaaS apps with Next.js 15, Supabase, Stripe, and other modern tech. It provides a solid base with auth, payments, an admin dashboard, i18n, and more.

Which technologies are included?

Do I need experience with all of these?

Not necessarily. The boilerplate is designed to be accessible. If you know React and understand TypeScript basics, you can work with it. The docs cover the specifics of each integration.

Setup & Configuration

How do I start a new project?

# Clone the repository
git clone https://github.com/ignitionstackpro/ignitionstack.pro.git meu-projeto
 
# Enter the directory
cd meu-projeto
 
# Install dependencies
npm install
 
# Configure environment variables
cp .env.example .env.local
 
# Start the development server
npm run dev

See the installation guide for more details.

Which environment variables are required?

At minimum you need:

# Supabase (required)
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
 
# App
NEXT_PUBLIC_APP_URL=http://localhost:3000

For specific features:

• Pagamentos: STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET
• Email: RESEND_API_KEY
• Analytics: NEXT_PUBLIC_GA_MEASUREMENT_ID

How do I configure Supabase locally?

1. Crie um projeto em supabase.com 
2. Copie as credenciais para .env.local
3. Execute as migrations: npx supabase db push

See the full Supabase guide.

Authentication

Which login methods are supported?

• Email/Password
• Magic Link (passwordless)
• Google OAuth
• GitHub OAuth

All configurable from the Supabase Dashboard under Authentication → Providers.

How do I protect admin routes?

Middleware already protects /admin/*. Unauthenticated users are redirected to /login.

// src/middleware.ts
if (request.nextUrl.pathname.startsWith('/admin') && !user) {
  return NextResponse.redirect(new URL('/login', request.url))
}

How do I add a new OAuth provider?

1. Ative o provider no Supabase Dashboard
2. Configure as credenciais (Client ID, Secret)
3. Add the login button on the frontend

Payments

How do I configure Stripe?

1. Crie conta em stripe.com 
2. Copie as API keys para .env.local
3. Configure webhooks no Dashboard

See the Stripe guide.

How do I test payments?

Use Stripe’s test cards:

• Sucesso: 4242 4242 4242 4242
• Requer 3DS: 4000 0025 0000 3155
• Recusado: 4000 0000 0000 9995

Does it support subscriptions?

Yes! The boilerplate supports:

• One-time payments
• Subscriptions (monthly/yearly)
• Customer Portal to manage subscriptions

Internationalization

Which languages are supported?

By default: Portuguese (pt), English (en), Spanish (es).

How do I add a new language?

1. Crie o arquivo de mensagens em src/i18n/messages/{locale}.json
2. Adicione o locale em src/i18n/config.ts
3. Traduza as strings

// src/i18n/config.ts
export const locales = ['en', 'pt', 'es', 'fr'] as const

How do I change the default language?

// src/i18n/config.ts
export const defaultLocale = 'pt'

Development

How do I add a new page?

1. Crie o arquivo em src/app/[locale]/(pages)/minha-pagina/page.tsx
2. Add translations if needed
3. The route will be available at /pt/minha-pagina

How do I create a new component?

# Estrutura recomendada
src/app/components/
└── MeuComponente/
    ├── index.tsx
    ├── MeuComponente.tsx
    └── MeuComponente.test.tsx

How do I add a Server Action?

// src/app/actions/minha-action.ts
'use server'
 
export async function minhaAction(data: FormData) {
  // Logic here
  return { success: true }
}

Deploy

Where can I deploy?

The boilerplate works best on:

• Vercel (recomendado)
• Netlify
• Railway
• Qualquer plataforma que suporte Next.js

Do I need a dedicated server?

No. The project uses serverless functions and can run on the free tiers of Vercel + Supabase.

How do I configure a custom domain?

1. Add the domain in your hosting platform
2. Configure DNS (CNAME or A record)
3. Update NEXT_PUBLIC_APP_URL in your env vars
4. Configure the domain in Supabase (Auth → URL Configuration)

Troubleshooting

Build is failing

# Clear caches
rm -rf .next node_modules
npm install
npm run build

React hydration error

Usually caused by:

• Server/client markup mismatch
• Browser extensions modifying the DOM
• Timestamps/dates rendered without consistent formatting

Supabase won’t connect

• Check environment variables
• Confirm the project is active
• Ensure your IP is allowed (Settings → Database)

Stripe webhook does not work

• Ensure the Stripe CLI is running (dev)
• Confirm STRIPE_WEBHOOK_SECRET
• Check Stripe dashboard logs

More Help

• Full Documentation