Skip to content

Integration Guide

Add Foundry to any JavaScript project in under 5 minutes. This guide covers the SDK setup, feedback, and automatic SDK updates.

Install the SDK

pnpm add @saas-maker/sdk
# or: npm install @saas-maker/sdk

Create your API key

Go to app.sassmaker.com and create a project
Copy the project API key (pk_...)
Add it to your environment

Next.js (App Router)

1. Environment variable

NEXT_PUBLIC_SAASMAKER_API_KEY=pk_your_key_here

2. SDK client

import { SaaSMakerClient } from '@saas-maker/sdk';

export const saasmaker = new SaaSMakerClient({
  apiKey: process.env.NEXT_PUBLIC_SAASMAKER_API_KEY!,
  baseUrl: 'https://api.sassmaker.com',
});

Vite + React

1. Environment variable

VITE_SAASMAKER_API_KEY=pk_your_key_here

2. SDK client

import { SaaSMakerClient } from '@saas-maker/sdk';

export const saasmaker = new SaaSMakerClient({
  apiKey: import.meta.env.VITE_SAASMAKER_API_KEY,
  baseUrl: 'https://api.sassmaker.com',
});

Automatic SDK Updates

Add this Dependabot config to automatically receive PRs when new SDK versions are released. Dependabot runs for free — it doesn’t count against your GitHub Actions minutes.

version: 2
updates:
  - package-ecosystem: npm
    directory: "/"
    schedule:
      interval: weekly
      day: monday
    allow:
      - dependency-name: "@saas-maker/sdk"
    commit-message:
      prefix: "deps"
    open-pull-requests-limit: 1

This checks for SDK updates every Monday and opens a PR if a new version is available.

Using the CLI

You can also initialize a project via the CLI:

npx @saas-maker/cli login
npx @saas-maker/cli init

This creates a foundry.json file linking your directory to a project. See the CLI docs for more.

What’s next?