sveltejs / sveltejs/kit

Feature: FlyWeb convention for machine-readable content discovery

Open
#15,326 0 comments 0 reactions 0 assignees View on GitHub

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.txt in static/)
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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.