Apprentice Pulse

A SvelteKit application for tracking apprenticeship progress, integrated with Airtable.

Setup

npm install

Create a .env.local file with your Airtable credentials:

AIRTABLE_API_KEY=your_api_key
AIRTABLE_BASE_ID_LEARNERS=your_base_id
AIRTABLE_BASE_ID_FEEDBACK=your_base_id

Development

npm run dev

Scripts

Command	Description
npm run dev	Start development server
npm run build	Build for production
npm run test	Run tests
npm run lint	Run ESLint
npx tsx scripts/fetch-schema.ts	Fetch Airtable schema
npx tsx scripts/test-airtable.ts	Test Airtable connection

Tech Stack

• SvelteKit
• TailwindCSS
• Airtable
• Vitest + Playwright

Airtable Integration

We reference Airtable tables and fields by their IDs rather than names to prevent breakage when users rename things.

Use returnFieldsByFieldId: true in select queries to access fields by ID:

const records = await table
  .select({
    filterByFormula: `{Field Name} = "value"`,
    returnFieldsByFieldId: true,
  })
  .all();

const value = record.get('fldXXXXXXXXXXXXXX'); // field ID

Limitation: filterByFormula still requires field names, not IDs. This is an Airtable API limitation. Document any field names used in formulas to track potential breaking changes.