Skip to content

feat: add TypeScript SDK demo app scaffold and Math Standards Alignment evaluator #132

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
adnanrhussain merged 6 commits into from
Jul 23, 2026
Merged

feat: add TypeScript SDK demo app scaffold and Math Standards Alignment evaluator #132

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
50ab903
Add TypeScript SDK demo app (Math Standards Alignment)
adnanrhussain Jul 16, 2026
7f99ecd
Address Copilot review: validate inputs, truncate KG errors, guard ju…
adnanrhussain Jul 16, 2026
8af67a0
refactor: split demo into scaffold + math-standards-alignment features
adnanrhussain Jul 16, 2026
ab2a619
docs: genericize spec Branch field to feature id
adnanrhussain Jul 16, 2026
5faecfc
fix: surface backend-down errors and reject blank statement codes
adnanrhussain Jul 16, 2026
2f04697
docs: mark math standards alignment end-to-end run verified
adnanrhussain Jul 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions demos/typescript/.env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Anthropic API key
ANTHROPIC_API_KEY=sk-ant-...

@czi-fsisenda czi-fsisenda Jul 23, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: should have quotes


# Learning Commons platform key
PLATFORM_API_KEY=...
3 changes: 3 additions & 0 deletions demos/typescript/.gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
node_modules/
dist/
.env
32 changes: 32 additions & 0 deletions demos/typescript/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# TypeScript SDK Demo

Minimal web app demonstrating the published
[`@learning-commons/evaluators`](https://www.npmjs.com/package/@learning-commons/evaluators)
SDK. The home page lists the available evaluator demos; each is its own page. React (Vite)
frontend + a small Express backend that runs the Node-only SDK.

Evaluators:

- **Math Standards Alignment** (`/math-standards-alignment`) — pick a grade, jurisdiction, and
standards, enter a math word problem, and view the evaluator's alignment result.

## Setup

```bash
npm install
cp .env.example .env # then fill in both keys
```

| Key | Purpose |
|---|---|
| `ANTHROPIC_API_KEY` | LLM calls (the evaluator's default model is Claude) |
| `PLATFORM_API_KEY` | Learning Commons Knowledge Graph (standards lookup) |

## Run

```bash
npm run dev
```

Open http://localhost:5173 to reach the home page (the Vite dev server proxies `/api` to the
backend on `:3001`), then pick an evaluator.
12 changes: 12 additions & 0 deletions demos/typescript/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Learning Commons Evaluators — SDK Demo</title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
Loading