PolicyEngine · MaxGhenis · May 9, 2026 · May 9, 2026
diff --git a/.github/workflows/pr.yaml b/.github/workflows/pr.yaml
@@ -0,0 +1,26 @@
+name: PR
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install --frozen-lockfile
+      - run: bun run build
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install --frozen-lockfile
+      - run: bun run lint
diff --git a/.gitignore b/.gitignore
@@ -45,10 +45,27 @@ Thumbs.db
 *.log
 
 # Data/cache
-data/
 .cache/
+# data/ is gitignored except for the stub fixtures committed for build/CI.
+data/*
+!data/households
+data/households/*
+!data/households/cliff_demo.json
+!data/households/all_households.json
 
 # Node.js / React
 node_modules/
 dist/
-.vite/
+.vite/
+
+# Next.js
+.next/
+out/
+next-env.d.ts
+*.tsbuildinfo
+
+# Vercel
+.vercel
+
+# Env
+.env*.local
diff --git a/src/index.css → app/globals.css b/src/index.css → app/globals.css
@@ -1,3 +1,6 @@
+@import "tailwindcss";
+@import "@policyengine/ui-kit/theme.css";
+
 /* PolicyEngine Design System - appv2 colors */
 :root {
   /* Primary Colors - Teal (from PolicyEngine appv2 designTokens) */

diff --git a/app/layout.tsx b/app/layout.tsx
@@ -0,0 +1,40 @@
+import type { Metadata, Viewport } from 'next';
+import './globals.css';
+
+export const metadata: Metadata = {
+  title: 'Understanding ACA Health Coverage Reforms | PolicyEngine',
+  description:
+    'Modeling how the scheduled expiration of IRA enhancements affects health insurance costs.',
+  icons: {
+    icon: '/favicon.svg',
+  },
+};
+
+export const viewport: Viewport = {
+  width: 'device-width',
+  initialScale: 1,
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <head>
+        <link rel="preconnect" href="https://fonts.googleapis.com" />
+        <link
+          rel="preconnect"
+          href="https://fonts.gstatic.com"
+          crossOrigin="anonymous"
+        />
+        <link
+          href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap"
+          rel="stylesheet"
+        />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
diff --git a/app/page.tsx b/app/page.tsx
@@ -0,0 +1,9 @@
+'use client';
+
+import dynamic from 'next/dynamic';
+
+const App = dynamic(() => import('@/App'), { ssr: false });
+
+export default function HomePage() {
+  return <App />;
+}
diff --git a/bun.lock b/bun.lock
diff --git a/data/households/all_households.json b/data/households/all_households.json
@@ -0,0 +1,39 @@
+{
+  "_stub": "Run `python precompute_households.py` to regenerate with real PolicyEngine output.",
+  "florida_family": {
+    "household_info": { "_stub": true },
+    "income_axis": [],
+    "ptc_baseline_2026": [],
+    "ptc_ira_2026": [],
+    "ptc_700fpl_2026": [],
+    "medicaid": [],
+    "chip": []
+  },
+  "texas_single": {
+    "household_info": { "_stub": true },
+    "income_axis": [],
+    "ptc_baseline_2026": [],
+    "ptc_ira_2026": [],
+    "ptc_700fpl_2026": [],
+    "medicaid": [],
+    "chip": []
+  },
+  "california_single_parent": {
+    "household_info": { "_stub": true },
+    "income_axis": [],
+    "ptc_baseline_2026": [],
+    "ptc_ira_2026": [],
+    "ptc_700fpl_2026": [],
+    "medicaid": [],
+    "chip": []
+  },
+  "pennsylvania_couple": {
+    "household_info": { "_stub": true },
+    "income_axis": [],
+    "ptc_baseline_2026": [],
+    "ptc_ira_2026": [],
+    "ptc_700fpl_2026": [],
+    "medicaid": [],
+    "chip": []
+  }
+}
diff --git a/data/households/cliff_demo.json b/data/households/cliff_demo.json
@@ -0,0 +1,25 @@
+{
+  "household_info": {
+    "age": 45,
+    "location": "Lebanon County, PA",
+    "fpl_percent": 650,
+    "state": "PA",
+    "_stub": "Run `python precompute_cliff_household.py` to regenerate with real PolicyEngine output."
+  },
+  "at_650_fpl": {
+    "income_2025": 0,
+    "income_2026": 0,
+    "slcsp_2025": 0,
+    "slcsp_2026": 0,
+    "ptc_2025_ira": 0,
+    "ptc_2026_ira": 0,
+    "ptc_2026_baseline": 0,
+    "ptc_2026_700fpl": 0
+  },
+  "income_axis": [],
+  "ptc_baseline_2026": [],
+  "ptc_ira_2026": [],
+  "ptc_700fpl_2026": [],
+  "medicaid": [],
+  "chip": []
+}
diff --git a/eslint.config.mjs b/eslint.config.mjs
@@ -0,0 +1,41 @@
+import nextCoreWebVitals from 'eslint-config-next/core-web-vitals';
+import nextTypescript from 'eslint-config-next/typescript';
+import { defineConfig, globalIgnores } from 'eslint/config';
+
+export default defineConfig([
+  ...nextCoreWebVitals,
+  ...nextTypescript,
+  {
+    rules: {
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+      'react/no-unescaped-entities': 'off',
+      '@next/next/no-img-element': 'off',
+      // Pre-existing React 18 patterns that this migration should not rewrite.
+      'react-hooks/set-state-in-effect': 'warn',
+      'react-hooks/static-components': 'warn',
+    },
+  },
+  {
+    files: ['src/app/layout.tsx'],
+    rules: {
+      '@next/next/no-page-custom-font': 'off',
+    },
+  },
+  globalIgnores([
+    '.next/**',
+    'out/**',
+    'build/**',
+    'coverage/**',
+    'dist/**',
+    'next-env.d.ts',
+    'public/**',
+    'data/**',
+    'aca_calc/**',
+    'pages/**',
+    'notebooks/**',
+    'tests/**',
+  ]),
+]);
diff --git a/index.html b/index.html
diff --git a/next.config.ts b/next.config.ts
@@ -0,0 +1,11 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  // Pin the workspace root so Turbopack does not silently pick up a stray
+  // lockfile from a parent directory during local development or CI.
+  turbopack: {
+    root: process.cwd(),
+  },
+};
+
+export default nextConfig;