Skip to content
Foundry Manual

Quickstart

1. Install the CLI

Section titled “1. Install the CLI”
Terminal window
npm install -g @saas-maker/cli

2. Log in

Section titled “2. Log in”
Terminal window
fnd login

Opens your browser for Google OAuth. Your session token is saved to ~/.foundry/config.json.

3. Create a project

Section titled “3. Create a project”
Terminal window
fnd projects create --name "My App"

This creates a project and prints its id, slug, and project_key (starts with pk_). Treat the pk_ key as your public-facing API key — the SDK and widgets use it. Drop --name to be prompted interactively.

Section titled “4. Link your app directory”
Terminal window
cd ~/my-app
fnd init

fnd init lists your projects, lets you pick one, and writes a foundry.json in the current directory linking the repo to the project.

5. Check your setup

Section titled “5. Check your setup”
Terminal window
fnd whoami   # show your session user and linked project
fnd keys     # print the linked project key
fnd doctor   # quick health + drift check

6. Integrate the SDK

Section titled “6. Integrate the SDK”
Terminal window
npm install @saas-maker/sdk
import { SaaSMakerClient } from '@saas-maker/sdk';


const client = new SaaSMakerClient({
  apiKey: 'pk_your_api_key',
  baseUrl: 'https://api.sassmaker.com',
});


await client.feedback.submit({
  title: 'Add dark mode',
  description: 'Would love a dark mode option',
  type: 'feature',
  submitter_email: 'user@example.com',
});

Or use curl directly:

Terminal window
curl -X POST https://api.sassmaker.com/v1/feedback \
  -H "Content-Type: application/json" \
  -H "X-Project-Key: pk_your_api_key" \
  -d '{
    "title": "Add dark mode",
    "description": "Would love a dark mode option",
    "type": "feature",
    "submitter_email": "user@example.com"
  }'

Next steps

Section titled “Next steps”