Local Development Setup¶

Prerequisites¶

• Node.js >= 20
• pnpm (enforced via .npmrc — npm and yarn will not work)

Install pnpm if you don't have it:

# Option A: corepack (built into Node.js >= 16.13)
corepack enable
corepack prepare pnpm@latest --activate

# Option B: npm global install
npm install -g pnpm

Clone and Install¶

git clone https://github.com/your-org/intune-assignments-manager.git
cd intune-assignments-manager
pnpm install

Environment Configuration¶

Create a .env file in the project root with your Azure app registration client ID:

PUBLIC_ENTRA_CLIENT_ID=your-client-id-here

See .env.example for the template. This is the only environment variable required.

Azure App Registration¶

You need a Microsoft Entra ID (Azure AD) app registration to authenticate:

1. Go to Microsoft Entra admin center > App registrations
2. Create or select your app registration
3. Copy the Application (client) ID into your .env file
4. Under Authentication, add a Single-page application platform with the redirect URI:

   http://localhost:5173
   

5. Ensure the following delegated API permissions are granted (Tier 1 scopes):
   • User.Read
   • DeviceManagementApps.ReadWrite.All
   • DeviceManagementConfiguration.ReadWrite.All
   • Group.Read.All

Dev Server¶

pnpm dev

Opens the app at http://localhost:5173. Vite provides hot module replacement for instant feedback during development.

Type Checking¶

pnpm check

Runs svelte-check with TypeScript in strict mode. This catches type errors across both .ts and .svelte files.

Linting¶

pnpm lint

Runs ESLint with a flat config and strict TypeScript rules.

Formatting¶

pnpm format

Runs Prettier with the project's configuration: tabs, single quotes, no trailing commas, 100-character line width.

Production Build¶

pnpm build

Builds the app using the Cloudflare Pages adapter. Output goes to .svelte-kit/cloudflare/.

Commands Reference¶