{"id":24764498,"url":"https://github.com/seamapi/edgespec","last_synced_at":"2025-10-11T14:30:47.706Z","repository":{"id":206844296,"uuid":"717839592","full_name":"seamapi/edgespec","owner":"seamapi","description":"☃️ an API framework for everywhere.","archived":false,"fork":false,"pushed_at":"2024-09-23T22:14:55.000Z","size":902,"stargazers_count":5,"open_issues_count":35,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-01-28T03:13:06.949Z","etag":null,"topics":["maintained"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seamapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-12T19:01:00.000Z","updated_at":"2024-11-14T16:02:02.000Z","dependencies_parsed_at":"2024-03-25T23:28:47.570Z","dependency_job_id":"9b5141cd-ac44-4b06-aa8b-c3bfb5bdb684","html_url":"https://github.com/seamapi/edgespec","commit_stats":null,"previous_names":["seamapi/edgespec"],"tags_count":71,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fedgespec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fedgespec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fedgespec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fedgespec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seamapi","download_url":"https://codeload.github.com/seamapi/edgespec/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236102175,"owners_count":19095198,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["maintained"],"created_at":"2025-01-28T22:31:53.481Z","updated_at":"2025-10-11T14:30:42.272Z","avatar_url":"https://github.com/seamapi.png","language":"TypeScript","readme":"# ☃️ edgespec\n\nEdgeSpec is an opinionated HTTP framework for TypeScript. Out of the box, it:\n\n- Uses filepath-based routing\n- [Soon] generates ergonomic SDKs across multiple languages\n- [Soon] generates OpenAPI documentation\n- Provides end-to-end type safety for your middleware and endpoints\n- Can be built into a zero-dependency module and embedded into other applications\n\nEdgeSpec primarily targets the [common minimum API described by WinterCG](https://github.com/wintercg/proposal-common-minimum-api), but it can also target Node.js, Bun, and Deno. Currently, the two main \"edge\"/WinterCG-compatible platforms targeted are Cloudflare Workers and Vercel Edge Functions.\n\nRegardless of your target, EdgeSpec provides a consistent API and encourages emulation of the WinterCG runtime when developing.\n\n## Getting Started\n\nTo start a new project:\n\n```bash\nnpm create edgespec@latest # [soon]\n\nnpm run dev\n```\n\nIf you want to add EdgeSpec to an existing project, check out [this recipe](./recipes/adding-edgespec-to-existing-project.md)\n\n## Usage\n\n- [Routes](./docs/routes.md) ⭐\n- [Middleware](./docs/middleware.md)\n- [Global route config](./docs/global-route-config.md)\n- [Code generation (typings \u0026 OpenAPI)](./docs/code-generation.md)\n- [EdgeSpec config](./docs/edgespec-config.md)\n- [Bundling \u0026 deployment](./docs/bundling-and-deployment.md) 🚀\n- [Embedding as a module](./docs/embedding.md)\n- [Programmatic usage](./docs/programmatic-usage.md)\n\n## Alternatives\n\nEdgeSpec may not be the right choice for your project. This list is not exhaustive, but here are some alternatives:\n\n- If your backend and frontend are tightly coupled:\n  - [Next.js](https://nextjs.org/) with React Server Components\n  - [Remix](https://remix.run/)\n  - [Express](http://expressjs.com/) or [Fastify](https://fastify.dev/) with [tRPC](https://trpc.io/)\n- If you dislike filepath-based routing and need to run within a WinterCG-compatible environment:\n  - [Hono](https://hono.dev/) (with or without [tRPC](https://trpc.io/))\n- If you enjoy dependency injection:\n  - [NestJS](https://nestjs.com/)\n- If your project is mainly frontend with a few API routes:\n  - [Next.js](https://nextjs.org/)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseamapi%2Fedgespec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseamapi%2Fedgespec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseamapi%2Fedgespec/lists"}