refactor(www): SDK-first website refresh#627
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refreshes the Foundry Local website messaging and examples to position Foundry Local as an SDK-first product (vs. a CLI-first flow), and updates installation/docs links accordingly.
Changes:
- Replaced the hero “two-step CLI” install flow with tabbed per-language SDK install commands and copy-to-reveal hello-world snippets.
- Updated homepage feature copy + the “Ship to Production” example to match current SDK patterns and a real model alias.
- Updated the download dropdown with correct Rust crate name and added WinML-specific install options; fixed Learn docs URLs across the site.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| www/src/lib/config.ts | Updates site description, feature card copy, and Learn docs URLs to SDK-first messaging. |
| www/src/lib/components/install-command.svelte | Introduces tabbed SDK install commands + per-language hello-world snippet reveal/copy. |
| www/src/lib/components/home/hero.svelte | Fixes primary Learn docs link to new /azure/foundry-local/ path. |
| www/src/lib/components/home/footer.svelte | Updates footer tagline and Learn docs link to SDK-first messaging + new docs path. |
| www/src/lib/components/home/features.svelte | Updates feature descriptions and replaces example code with current SDK usage + real model alias. |
| www/src/lib/components/download-dropdown.svelte | Fixes Rust crate name, adds WinML install variants for all languages, and refines labels. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Hero: Replace CLI install (winget/brew + foundry model run) with
tabbed SDK install commands (pip/npm/dotnet/cargo) and per-language
hello-world code snippets that show the full lifecycle
- Features: Fix code example from wrong API (getCatalog().getModel('gpt-oss-20b'))
to correct SDK pattern (catalog.getModel('qwen2.5-0.5b') + download/load/chat)
- Download dropdown: Fix Rust package (foundry-local -> foundry-local-sdk),
add WinML variants for all languages (pip/npm/dotnet/cargo)
- Fix all docs links from azure/ai-foundry/foundry-local/ to azure/foundry-local/
- Update footer tagline to SDK-era messaging
- Update config description and feature descriptions to reflect
SDK-first positioning, ~20 MB runtime, EP management
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
- C#: add required NullLogger.Instance param to CreateAsync - Rust: add type hint None::<fn(f64)> for download() generic Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
MaanavD
force-pushed
the
website-sdk-refresh
branch
from
b996516 to
c1457eb
Compare
## What changed Redesigned the Foundry Local homepage to make the SDK the primary path for new users, with the first viewport focused on app integration rather than CLI tooling. - Updated hero copy and CTAs for an SDK-first story. - Reworked the install widget into three stacked steps: install package, load a model, and run chat inference. - Added Python, JS, C#, and Rust tabs with compact syntax-highlighted snippets. - Added progressive 1 -> 2 -> 3 reveal: steps unlock on copy or click, with a reduced-motion-aware animation. - Kept the inference step honest to the existing samples by showing the chat path instead of adding unsupported chat/speech/vision sub-tabs. - Fixed copy toast theming to use semantic site tokens. - Updated the install dropdown, features, and footer to keep SDKs primary and CLI tooling secondary. ## Testing - `npx prettier --check src/lib/config.ts src/lib/components/install-command.svelte` - `npm run build` --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
baijumeswani
previously approved these changes
May 20, 2026
- Download dropdown: SDK installs (with stacked Cross-platform/Windows badges) now appear above CLI tools; labels updated to 'Start with an SDK' and 'Optional CLI tools' - Download dropdown: fix copiedItem -> copiedItemId, extract typed CliInstallOption / SdkInstallOption arrays, drop unused Button import - install-command.svelte: C# snippet now includes missing using statement, null-check on GetModelAsync, and proper ChatMessage usage - models page: replace large CLI Card with a compact single-row strip (Windows install | macOS install | Run command) that copy to clipboard on click; strip ordered install-first then run Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
baijumeswani
approved these changes
May 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Foundry Local is now delivered as a native SDK (~20 MB) that ships inside your app. The website still led with CLI install commands (
winget install+foundry model run), which framed it as a CLI tool. This PR updates the website to reflect the SDK-first positioning.Changes
Hero / Install Command (
install-command.svelte)winget install→foundry model run) with tabbed SDK install commands (Python / JS / C# / Rust)pip install/npm install/dotnet add package/cargo addcommandFeatures Section (
features.svelte)manager.getCatalog().getModel('gpt-oss-20b')(wrong API, fake model). Now shows correct SDK pattern:catalog.getModel('qwen2.5-0.5b')withdownload()→load()→createChatClient()→completeChat()Download Dropdown (
download-dropdown.svelte)cargo add foundry-local→cargo add foundry-local-sdk-winmlpackages)Docs Links (all files)
azure/ai-foundry/foundry-local/→azure/foundry-local/across hero, nav, footer, and configMessaging Updates (
config.ts,footer.svelte)Verification
svelte-check: 18 errors before, 18 errors after (all pre-existing in UI library types, zero introduced)Not included (separate repo: MicrosoftDocs/azure-ai-docs)
A docs discrepancy audit found 14 issues in the Learn docs. Key items:
asyncio.run()(4 pages)chunk.choices[0].message.contentinstead ofdelta.content(2 pages)Full audit available on request.