This tool is in active development. You're using an Alpha version, which means:
Expect Changes: Features, UI, and behavior may change without notice as we improve the builder
Bugs Happen: You may encounter errors or unexpected behavior - please report them so we can fix them
Active Improvement: We're rapidly iterating based on user feedback and testing
Your Input Matters: Help shape the future of Interition by sharing your experience on Discord
Understanding Solid Architecture: Apps built with Interition follow Solid principles - your users control where their data is stored, not you or us. Two storage providers are available: Inrupt PodSpaces (works everywhere, designed for development/testing per their terms) and Solid Community Server (works on localhost but has known issues on some hosting platforms due to browser sessionStorage not persisting across redirects - if this affects you, please raise it with the Solid Community Server team). Interition has no control over, access to, or influence on Pod storage providers. App code issues could affect data structure/schema in your users' Pods. We strongly encourage you to familiarize yourself with Solid design patterns - they differ fundamentally from traditional centralized server architectures, but that's precisely what makes them powerful for user privacy and data sovereignty
Project Safety: Save your builder projects locally (Download ZIP) as a precaution during Alpha
Thank you for being an early adopter! Your participation helps us build a better tool for everyone.
Key Terms
Solid
An open web standard, created by Sir Tim Berners-Lee, that lets people and agents store their data
in a personal store (a Pod) they control, rather than inside an app's database.
Apps request access; you grant, deny, or revoke it. Full explainer →
Context Graph
A structured, continuously-updated record of how decisions get made — your agents' identity, memory,
decisions, and audit trail, as linked data you own. Gartner (2026) calls context graphs "the new
essential infrastructure for agentic systems." Solid is the open substrate; your context graph is
what you build on it — open and portable, not locked in a vendor's platform.
Learn more →
1. What You Need
Anthropic API Key (Required to Build Apps)
What: API key from Anthropic to access Claude AI
Why: The builder uses Claude to generate code from your prompts
When a user authenticates, the app fetches their WebID document (e.g., https://id.inrupt.com/username) to find their Pod storage location. If this returns a 404 error, it means:
The account can authenticate (username/password works)
But the WebID profile document doesn't exist yet
This typically happens with partially-completed account registrations
8. Staying Up to Date
Important: Interition is in alpha and changes frequently. Before troubleshooting issues, make sure you're running the latest version.
How to Refresh for the Latest Version
Your browser may cache the app, showing an older version. To ensure you have the latest:
Hard Refresh (Quick Method)
Windows/Linux: Press Ctrl + Shift + R
Mac: Press Cmd + Shift + R
Full Cache Clear (If Hard Refresh Doesn't Work)
Open browser settings
Navigate to Privacy/History settings
Clear cached images and files (you can keep cookies and passwords)
Refresh the page
Checking Your Version
The current version is shown at the bottom of the Settings panel. Compare this with the latest release to confirm you're up to date.
Why This Matters
Alpha versions may have breaking changes between releases
Bugs you encounter may already be fixed in a newer version
New features and improvements are released frequently
9. Troubleshooting
Data Management
These options are available in Settings under "Dangerous Actions":
Delete API Key: Removes your saved Anthropic API key from localStorage
Reset All App Data: Clears all localStorage data including:
All saved projects
API key
Subscription status cache
All settings
Warning: Reset All App Data cannot be undone. Export your projects first if you want to keep them.
Problem: "Build" button doesn't work / nothing happens
Solution:
Check you've added an Anthropic API key:
Settings → API Key field should be filled
Key should start with "sk-ant-"
Check browser console for errors (F12 → Console tab)
Problem: Preview shows "Error: Failed to generate component"
Possible Causes:
Invalid or expired API key → Update in Settings
Anthropic API quota exceeded → Check your Anthropic billing
Prompt was unclear → Try rephrasing more specifically
Network issue → Check internet connection
Problem: Deployment fails
For One-Click Web Deployment:
Verify you're subscribed to Pro (Settings → check subscription status)
Check you've connected Netlify account (try disconnecting and reconnecting)
Verify site name is available and valid:
Must be 3-63 characters
Lowercase letters, numbers, hyphens only
Cannot start/end with hyphen
Check browser console for error details
Problem: Preview is blank or shows old code
Solutions:
Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
Clear browser cache: Settings → Privacy → Clear browsing data
Try a different browser (Chrome or Firefox recommended)
Problem: "Subscription required" message but I'm subscribed
Solutions:
Refresh the page (sometimes subscription check needs refresh)
Settings → Verify subscription shows as "Active"
Check payment succeeded in Stripe (link in Settings → Manage Billing)
Wait 1-2 minutes for webhook to process
Problem: Exported app shows "Invalid client_id" error with Inrupt PodSpaces
Symptom: When running an exported app locally or on deployment, you see an error message like:
{"status":401,"title":"Unauthorized","detail":"Invalid client_id"...}
Cause: This occurs when your browser has cached authentication data from a previous Inrupt PodSpaces session that has expired or been invalidated.
Solutions:
Quick fix: Open the app in an incognito/private browser window
Permanent fix: Clear browser data for the app's domain:
Chrome/Edge: Click lock icon in address bar → Site settings → Clear data
Or: DevTools (F12) → Application → Clear site data
Clear: Cookies, Cache, and Local Storage
After clearing, hard refresh the page: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
Prevention: This issue only affects development/testing. Deployed apps on unique domains won't have stale session data.
Problem: "403 Forbidden" error when logging in to Inrupt PodSpaces
Symptom: When trying to log in with Inrupt PodSpaces, you see an error like:
Cause: Your browser has stored old Solid authentication data that has become invalid or expired. This can happen after failed login attempts or when authentication tokens expire.
Solution: Clear the Solid login data from your browser. Follow the steps for your browser below:
For Google Chrome:
Open the app in Chrome (the page where you're getting the error)
Press F12 on your keyboard (or right-click anywhere and select "Inspect")
A panel will open - click the Application tab at the top
If you don't see it, click the >> arrows to find it
In the left sidebar, click Local Storage, then click on the website address below it
Look for any rows that start with solidClientAuthenticationUser
Click on each one and press the Delete key, or right-click and select "Delete"
Close the panel (click the X or press F12 again)
Refresh the page and try logging in again
For Firefox:
Open the app in Firefox (the page where you're getting the error)
Press F12 on your keyboard (or right-click anywhere and select "Inspect")
A panel will open - click the Storage tab at the top
In the left sidebar, click Local Storage, then click on the website address below it
Look for any rows that start with solidClientAuthenticationUser
Right-click on each one and select "Delete"
Close the panel (click the X or press F12 again)
Refresh the page and try logging in again
For Safari (Mac):
First enable developer tools: Safari menu → Settings → Advanced → Show Develop menu
Open the app in Safari
Press Option + Command + I (or Develop menu → Show Web Inspector)
Click the Storage tab
Click Local Storage in the sidebar
Find and delete any rows starting with solidClientAuthenticationUser
Close the inspector and refresh the page
Quick Alternative: Try opening the app in an incognito/private browser window - this starts with a clean slate and often resolves the issue immediately.
Still not working? Try using a different browser (Firefox often works when Chrome doesn't, or vice versa).