🔍

🚀 Guía de Inicio Rápido

Pon tu boilerplate SAAS en funcionamiento en menos de 10 minutos. Esta guía te tendrá lanzando el mismo día.

📋Prerrequisitos

  • ✅Node.js 18+ instalado
  • ✅Base de datos MongoDB (el nivel gratuito funciona)
  • ✅Cuenta de servicio de email (Resend recomendado)
  • ✅Cuenta de proveedor de pagos (Stripe o LemonSqueezy)

1Clone & Install

git clone <https://github.com/velox-inside/velox-inside> cd velox-inside npm install

2Environment Setup

Create a .env.local file in your project root:

# Database
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/your-db

# Authentication
AUTH_SECRET=your-random-secret-key-here
NEXTAUTH_URL=http://localhost:3000

# Email Service (Resend)
RESEND_API_KEY=re_your_resend_api_key
EMAIL_FROM=your-verified-email@domain.com
YOUR_EMAIL=your-verified-email@domain.com

# Payment Providers (choose one or both)
STRIPE_SECRET_KEY=sk_test_your_stripe_secret_key
STRIPE_PUBLISHABLE_KEY=pk_test_your_stripe_publishable_key

# Optional: LemonSqueezy
LEMONSQUEEZY_API_KEY=your_lemonsqueezy_api_key
LEMONSQUEEZY_STORE_ID=your_store_id

# Launch Control
NEXT_PUBLIC_IS_LAUNCHED=false

3Database Setup

Your MongoDB will be automatically configured when you first run the app. No manual setup required.

4Run Development Server

npm run dev

Visit http://localhost:3000 - you'll see the waitlist page.

5Create Admin Account

  1. 1Go to http://localhost:3000/auth
  2. 2Click "Register Admin"
  3. 3Enter your email and password
  4. 4You're now the admin!

6Set Up Your Home Page

Important:

The home page comes with placeholder content. You need to customize it:

  1. 1Open app/page.tsx
  2. 2Delete the existing content inside the <section> tag
  3. 3Add your components exactly as they are in the current implementation
// Replace the content inside the section with:
<NavbarHome palette={palette} />
<Header />
<Testimonials />
<AboutSection palette={palette} />
<SuccessStories palette={palette} />
<FaqSection palette={palette} />
<PricingSection />
<div className="flex justify-center p-4 sm:p-6 md:p-8 py-16 sm:py-20 md:py-24 lg:py-28 xl:py-32">
  <CtaCard
    title="Unlock your team's potential."
    description="Our all-in-one solution integrates with your existing tools, providing the insights you need to drive growth and scale your business."
    buttonText="Request a Demo"
    paletteKey={palette}
  />
</div>
<Footer />

7Configure Your App

💳Set Up Products (Stripe)

  1. 1Go to /admin/product-panel
  2. 2Add your products with Stripe price IDs
  3. 3Configure pricing and features

🎨Customize Your Brand

  • •Edit app/page.tsx to change the palette (palette1, palette2, or palette3)
  • •Update content in components
  • •Add your logo and branding

8Test the Flow

Waitlist

Users can join your waitlist

Admin Dashboard

Manage users, send emails, create blog posts

Payment

Test with Stripe test mode

Blog

Create and publish content

9Launch Your App

When ready to launch:

NEXT_PUBLIC_IS_LAUNCHED=true

This switches from waitlist mode to full app mode with pricing and checkout.

10Deploy to Production

▲Vercel (Recommended)

  1. 1Push to GitHub
  2. 2Connect to Vercel
  3. 3Add environment variables in Vercel dashboard
  4. 4Deploy!

🌐Other Platforms

  • •Netlify, Railway, or any Node.js hosting
  • •Set NEXTAUTH_URL to your production domain
  • •Configure MongoDB Atlas for production

⚡Quick Commands

Development

npm run dev

Build for production

npm run build

Start production server

npm start

Lint code

npm run lint

✨What You Get

✅Authentication: Magic link + admin login
✅Payments: Stripe + LemonSqueezy support
✅Email: Automated emails with Resend
✅Admin Panel: User management, blog, analytics
✅Waitlist System: Pre-launch user collection
✅Blog System: Content management
✅Analytics: Session tracking and user stats
✅Responsive Design: Mobile-first, 3 color themes

🆘Need Help?

  • •Check the full documentation for detailed guides
  • •Review the code comments for implementation details
  • •Test in development before deploying to production

You're ready to launch! 🚀

Follow this guide and you'll have your SaaS application running in no time.