Feature: FlyWeb convention for machine-readable content discovery
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 20.8k
- Forks
- 2.3k
- Avg merge
- 1d 16h
- Merged PRs (30d)
- 156
Description
What
FlyWeb is an open protocol that lets websites describe their structured data for AI agents. A site publishes /.well-known/flyweb.json:
{
"flyweb": "1.0",
"entity": "My App",
"type": "docs",
"resources": {
"articles": {
"path": "/.flyweb/articles",
"format": "jsonl",
"fields": ["title", "author", "date", "content"],
"query": "?tag={tag}"
}
}
}
robots.txt tells machines where not to go. flyweb.json tells them what you have.
Why SvelteKit
SvelteKit already has patterns for serving structured files — +server.ts route files work perfectly for this:
// src/routes/.well-known/flyweb.json/+server.ts
import { json } from '@sveltejs/kit';
export function GET() {
return json({
flyweb: '1.0',
entity: 'My App',
type: 'blog',
resources: {
posts: {
path: '/.flyweb/posts',
format: 'jsonl',
fields: ['title', 'author', 'date', 'content'],
query: '?tag={tag}',
},
},
});
}
A native integration could provide:
- Type-safe helper functions (
import { flyweb } from '$app/flyweb') - Auto-generation from your data structure
- Convention file support (like
robots.txtinstatic/)
Context
AI agents are becoming primary consumers of web content. They scrape HTML, guess at structure, and hallucinate when wrong. FlyWeb gives them a standard discovery mechanism — like robots.txt but for structured data access.
Existing Implementation
- Spec: SPEC.md
- npm:
flyweb(core + CLI validator) - CLI:
npx flyweb check https://example.com - Next.js RFC: vercel/next.js#90075
- Homepage: flyweb.io
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the linked SPEC.md and the SvelteKit +server.ts route pattern shown in the issue. Compare the proposed type-safe helpers, auto-generation, and static convention support with the linked flyweb npm package and Next.js RFC; done requires a defined scope for native SvelteKit support.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, typescript
- Domain
- web-dev
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100