Installation

This guide walks you through installing SaaSStinger Lite and running it on your local machine.

By the end of this guide, you'll have a fully functional development environment connected to your own Firebase project.

Before You Begin

Make sure your development environment meets the recommended requirements.

Verify your installation by running:

node -v
pnpm -v
firebase --version
git --version

You should see version numbers for each command.

Clone the Repository

Clone your SaaSStinger Lite repository.

git clone <repository-url>

Move into the project directory.

cd saasstinger-lite

Install Dependencies

Install all project dependencies using pnpm.

pnpm install

Depending on your internet connection, this may take a few minutes.

Once complete, you'll have all required packages installed.

Configure Environment Variables

Copy the example environment file.

cp .env.example .env.local

Open .env.local and add your Firebase project credentials.

A typical configuration looks like this:

NEXT_PUBLIC_FIREBASE_API_KEY=your-api-key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your-project-id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your-project.appspot.com
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=xxxxxxxx
NEXT_PUBLIC_FIREBASE_APP_ID=xxxxxxxx

You'll configure these values in detail in the Firebase Setup guide.

Start the Development Server

Run the application.

pnpm dev

By default, the application starts at:

http://localhost:3000

Open the URL in your browser.

If everything has been configured correctly, you should see the SaaSStinger Lite marketing website.

Verify the Installation

Before continuing, verify the following:

• The development server starts without errors.
• The homepage loads successfully.
• No environment variable errors appear.
• No Firebase initialization errors appear.
• TypeScript compiles successfully.

Recommended Development Commands

Start the development server

pnpm dev

Build for production

pnpm build

Start the production build

pnpm start

Run ESLint

pnpm lint

Run TypeScript checks

pnpm tsc --noEmit

These commands should become part of your regular development workflow.

Common Installation Issues

pnpm: command not found

Install pnpm globally.

npm install -g pnpm

Incorrect Node.js Version

Using an unsupported Node.js version may cause dependency or build issues.

Check your version.

node -v

We recommend Node.js 22 LTS.

Missing Environment Variables

If the application reports missing Firebase configuration values, double-check your .env.local file.

Make sure:

• Every required variable is present.
• Variable names match exactly.
• The development server has been restarted after making changes.

Firebase Not Initialized

If Firebase fails to initialize:

• Verify your project credentials.
• Ensure the Firebase project exists.
• Confirm Authentication and Firestore have been enabled.

The next guide covers this process in detail.

Development Workflow

A typical development workflow looks like this:

1. Pull the latest changes.
2. Install dependencies if needed.
3. Start the development server.
4. Implement your feature.
5. Run TypeScript checks.
6. Run ESLint.
7. Test the application.
8. Commit your changes.

Following this workflow helps catch issues before deployment.

Next Steps

Your local development environment is now ready.

Continue with:

• System Requirements
• Firebase Setup
• Environment Variables

These guides will prepare your project for authentication, Firestore, and production-ready development.