# Code generator playground

The page at https://apigenie.pl/tools/generator/playground runs `apigenie-generator`, built for WebAssembly from the same source as the CLI, in the browser: pick a target and an API document (a sample or your own), and it shows the generated files, offers them as a .zip, and asks which features matter most for the target. The document stays in the browser. The command the page shows writes the same files with the same version, for example `apigenie-generator client fetch petstore.yaml -o out`, run where no `apigenie.yaml` applies.

A link opens the page on a target, a sample and options: `https://apigenie.pl/tools/generator/playground#t=<target>&s=<sample>&pn=<package name>&pv=<package version>&x=<further arguments>`, and runs it.

## Targets

- `client_fetch`: [`apigenie-generator client fetch`](https://apigenie.pl/docs/reference/generator/client-fetch.md), OpenAPI, Tier 1
- `client_go`: [`apigenie-generator client go`](https://apigenie.pl/docs/reference/generator/client-go.md), OpenAPI, Tier 1
- `client_swift`: [`apigenie-generator client swift`](https://apigenie.pl/docs/reference/generator/client-swift.md), OpenAPI, experimental
- `server_vapor`: [`apigenie-generator server vapor`](https://apigenie.pl/docs/reference/generator/server-vapor.md), OpenAPI, experimental
- `server_hummingbird`: [`apigenie-generator server hummingbird`](https://apigenie.pl/docs/reference/generator/server-hummingbird.md), OpenAPI, experimental
- `client_rust`: [`apigenie-generator client rust`](https://apigenie.pl/docs/reference/generator/client-rust.md), OpenAPI, experimental
- `server_axum`: [`apigenie-generator server axum`](https://apigenie.pl/docs/reference/generator/server-axum.md), OpenAPI, experimental
- `server_fastapi`: [`apigenie-generator server fastapi`](https://apigenie.pl/docs/reference/generator/server-fastapi.md), OpenAPI, Tier 1
- `client_csharp`: [`apigenie-generator client csharp`](https://apigenie.pl/docs/reference/generator/client-csharp.md), OpenAPI, Tier 1
- `client_python`: [`apigenie-generator client python`](https://apigenie.pl/docs/reference/generator/client-python.md), OpenAPI, Tier 1
- `client_java`: [`apigenie-generator client java`](https://apigenie.pl/docs/reference/generator/client-java.md), OpenAPI, Tier 1
- `client_elixir`: [`apigenie-generator client elixir`](https://apigenie.pl/docs/reference/generator/client-elixir.md), OpenAPI, Tier 2
- `client_elixir_protobuf`: [`apigenie-generator client elixir`](https://apigenie.pl/docs/reference/generator/client-elixir-protobuf.md), Protobuf, Tier 2
- `server_express`: [`apigenie-generator server express`](https://apigenie.pl/docs/reference/generator/server-express.md), OpenAPI, Tier 2
- `server_mcp`: [`apigenie-generator server mcp`](https://apigenie.pl/docs/reference/generator/server-mcp.md), OpenAPI, Tier 2, experimental
- `server_orpc`: [`apigenie-generator server orpc`](https://apigenie.pl/docs/reference/generator/server-orpc.md), OpenAPI, Tier 2
- `server_go`: [`apigenie-generator server go`](https://apigenie.pl/docs/reference/generator/server-go.md), OpenAPI, Tier 1
- `server_aspnet`: [`apigenie-generator server aspnet`](https://apigenie.pl/docs/reference/generator/server-aspnet.md), OpenAPI, Tier 1
- `server_phoenix`: [`apigenie-generator server phoenix`](https://apigenie.pl/docs/reference/generator/server-phoenix.md), OpenAPI, Tier 2
- `server_elixir_grpc`: [`apigenie-generator server elixir-grpc`](https://apigenie.pl/docs/reference/generator/server-elixir-grpc.md), Protobuf, Tier 2
- `server_spring`: [`apigenie-generator server spring`](https://apigenie.pl/docs/reference/generator/server-spring.md), OpenAPI, Tier 1
- `schema_zod`: [`apigenie-generator schema zod`](https://apigenie.pl/docs/reference/generator/schema-zod.md), OpenAPI, experimental
- `client_ws`: [`apigenie-generator client ws`](https://apigenie.pl/docs/reference/generator/client-ws.md), AsyncAPI, Tier 2
- `client_kafkajs`: [`apigenie-generator client kafkajs`](https://apigenie.pl/docs/reference/generator/client-kafkajs.md), AsyncAPI, Tier 2
- `server_ws`: [`apigenie-generator server ws`](https://apigenie.pl/docs/reference/generator/server-ws.md), AsyncAPI, Tier 2
- `server_kafkajs`: [`apigenie-generator server kafkajs`](https://apigenie.pl/docs/reference/generator/server-kafkajs.md), AsyncAPI, Tier 2
- `client_go_asyncapi`: [`apigenie-generator client go`](https://apigenie.pl/docs/reference/generator/client-go-asyncapi.md), AsyncAPI, Tier 2
- `server_faststream`: [`apigenie-generator server faststream`](https://apigenie.pl/docs/reference/generator/server-faststream.md), AsyncAPI, Tier 2
- `client_java_asyncapi`: [`apigenie-generator client java`](https://apigenie.pl/docs/reference/generator/client-java-asyncapi.md), AsyncAPI, Tier 2
- `client_python_asyncapi`: [`apigenie-generator client python`](https://apigenie.pl/docs/reference/generator/client-python-asyncapi.md), AsyncAPI, Tier 2
- `client_csharp_asyncapi`: [`apigenie-generator client csharp`](https://apigenie.pl/docs/reference/generator/client-csharp-asyncapi.md), AsyncAPI, Tier 2
- `server_aspnet_asyncapi`: [`apigenie-generator server aspnet`](https://apigenie.pl/docs/reference/generator/server-aspnet-asyncapi.md), AsyncAPI, Tier 2
- `server_go_asyncapi`: [`apigenie-generator server go`](https://apigenie.pl/docs/reference/generator/server-go-asyncapi.md), AsyncAPI, Tier 2
- `client_elixir_asyncapi`: [`apigenie-generator client elixir`](https://apigenie.pl/docs/reference/generator/client-elixir-asyncapi.md), AsyncAPI, Tier 2
- `server_phoenix_asyncapi`: [`apigenie-generator server phoenix`](https://apigenie.pl/docs/reference/generator/server-phoenix-asyncapi.md), AsyncAPI, Tier 2
- `server_spring_asyncapi`: [`apigenie-generator server spring`](https://apigenie.pl/docs/reference/generator/server-spring-asyncapi.md), AsyncAPI, Tier 2
- `server_absinthe`: [`apigenie-generator server absinthe`](https://apigenie.pl/docs/reference/generator/server-absinthe.md), GraphQL, Tier 2

## Samples

- `petstore`: Petstore (OpenAPI 3.0, 3 operations); https://apigenie.pl/tools/generator/playground/samples/petstore/petstore.yaml
- `carpet-express-openapi`: Carpet Express (OpenAPI 3.1, the conformance fixture); https://apigenie.pl/tools/generator/playground/samples/openapi/carpet-express.openapi-31.yaml
- `carpet-express-asyncapi`: Carpet Express (AsyncAPI 3.0); https://apigenie.pl/tools/generator/playground/samples/asyncapi/carpet-express.asyncapi.yaml
- `carpet-express-graphql`: Carpet Express (GraphQL); https://apigenie.pl/tools/generator/playground/samples/graphql/carpet-express.graphql
- `carpet-express-protobuf`: Carpet Express (Protobuf, 9 files); https://apigenie.pl/tools/generator/playground/samples/protobuf/carpet-express.proto, https://apigenie.pl/tools/generator/playground/samples/protobuf/carpetexpress/v1/account.proto, https://apigenie.pl/tools/generator/playground/samples/protobuf/carpetexpress/v1/common.proto, https://apigenie.pl/tools/generator/playground/samples/protobuf/carpetexpress/v1/pickups.proto, https://apigenie.pl/tools/generator/playground/samples/protobuf/carpetexpress/v1/rates.proto, https://apigenie.pl/tools/generator/playground/samples/protobuf/carpetexpress/v1/shipments.proto, https://apigenie.pl/tools/generator/playground/samples/protobuf/carpetexpress/v1/tracking.proto, https://apigenie.pl/tools/generator/playground/samples/protobuf/carpetexpress/v1/warehouses.proto, https://apigenie.pl/tools/generator/playground/samples/protobuf/carpetexpress/v1/webhooks.proto

## Questions

The page asks these after a run, one at a time; their definition, with stable ids, is https://apigenie.pl/tools/generator/playground/surveys.json.

- `next-feature` (client targets of OpenAPI, any number of answers): Which of these matter most to you in this client? `retries` Retries and timeouts; `pagination` Helpers for paginated lists; `auth` Built-in auth flows (OAuth 2.0, refresh tokens); `streaming` Streaming responses and server-sent events; `http-library` A choice of HTTP library; `smaller` Less code, fewer files; `docs` Usage examples in the generated README; `other` with your own words
- `next-feature` (server targets of OpenAPI, any number of answers): Which of these matter most to you in this server? `validation` Stricter request validation; `auth` Security handlers wired from the spec; `framework-version` Another framework or framework version; `observability` Logging, metrics and tracing hooks; `stubs` Handler stubs that return the spec's examples; `smaller` Less code, fewer files; `docs` Usage examples in the generated README; `other` with your own words
- `next-feature` (client, server targets of AsyncAPI, any number of answers): Which of these matter most to you in this client or server? `reconnect` Reconnects and retries with backoff; `request-reply` Request-reply helpers; `errors` Typed errors and dead-letter handling; `validation` Messages checked against their schemas; `observability` Logging, metrics and tracing hooks; `framework-version` Another library or framework version; `smaller` Less code, fewer files; `docs` Usage examples in the generated README; `other` with your own words
- `next-feature` (client, server targets of Protobuf, GraphQL, any number of answers): Which of these matter most to you in this client or server? `deadlines` Deadlines and retries on calls; `middleware` Interceptors or middleware for auth and logging; `streaming` Streaming calls and subscriptions; `framework-version` Another library or framework version; `smaller` Less code, fewer files; `docs` Usage examples in the generated README; `other` with your own words
- `next-feature` (schema targets, any number of answers): Which of these matter most to you in these schemas? `formats` More string formats checked; `messages` Custom error messages; `recursive-types` Inferred types for recursive schemas instead of unknown; `smaller` Less code, fewer files; `other` with your own words
- `would-use` (client, server, schema targets, one answer): Would you use this output in a project? `as-is` Yes, as it is; `with-changes` Yes, after small changes; `not-yet` Not yet: something important is missing; `no` No, I'd write it by hand; `other` with your own words

An agent answers through an issue rather than the form on the page: it opens an issue at https://github.com/mykulyak/api-genie/issues/new whose body holds this block. The labels `generator`, `playground` and `survey` help, but only maintainers can set them; the `kind` line is what is counted.

```yaml
kind: generator-survey
survey: next-feature
target: client_fetch
version: "apigenie-generator <version>"
answers: [retries, other]
other: "what other means, in a sentence"
respondent: agent
```

A problem with generated code is an issue whose body holds this block, followed by what is wrong and what was expected. `input` is a sample's id, or `own` with the document, or the smallest part of it that shows the problem, attached.

```yaml
kind: generator-output
target: client_fetch
version: "apigenie-generator <version>"
command: "apigenie-generator client fetch petstore.yaml -o out"
input: petstore
file: "src/operations.ts"
respondent: agent
```
