Skip to content

docs: Railpack provider values in schema enum#558

Merged
iloveitaly merged 1 commit into
railwayapp:mainfrom
radiantjade:document-provider-values
May 30, 2026
Merged

docs: Railpack provider values in schema enum#558
iloveitaly merged 1 commit into
railwayapp:mainfrom
radiantjade:document-provider-values

Conversation

@radiantjade

Copy link
Copy Markdown
Contributor

Summary

  • add provider enum values to the generated railpack schema output
  • document the available provider values in the config file guide
  • make configured provider lookup case-insensitive so the documented lowercase values work for elixir and dotnet

This also clarifies that uv support is handled by the python provider, not a separate provider.

Related Central Station question: https://station.railway.com/questions/what-are-the-available-providers-in-rail-bae3a690

Verification

  • git diff --check
  • go test ./core/config ./core/providers
  • go run ./cmd/cli schema shows the provider enum
  • bun run build in docs

I also tried go test ./...; it did not complete cleanly in this environment because existing example snapshots resolve newer Caddy/FrankenPHP patch versions and integration tests require BUILDKIT_HOST. Those failures appear unrelated to this change.

The config schema did not enumerate provider values, and the configuration docs only described the field generically. Add explicit provider enum values to the generated schema, document the same values in the config file guide, and make provider lookup case-insensitive so lowercase documented values work for providers whose internal names are capitalized.

Constraint: Central Station bounty asks for provider names to be discoverable in docs and JSON schema

Rejected: Docs-only update | would leave railpack schema incomplete

Confidence: high

Scope-risk: narrow

Directive: Keep provider docs and schema enum aligned with core/providers/provider.go

Tested: go test ./core/config ./core/providers; bun run build in docs; go run ./cmd/cli schema shows provider enum; git diff --check

Not-tested: go test ./... fails on existing environment/snapshot drift: Caddy/FrankenPHP patch snapshots and missing BUILDKIT_HOST for integration tests
@iloveitaly iloveitaly force-pushed the document-provider-values branch from 5abae10 to 7aca227 Compare May 30, 2026 11:48
@iloveitaly iloveitaly changed the title Document Railpack provider values docs: Railpack provider values in schema enum May 30, 2026
@iloveitaly

Copy link
Copy Markdown
Collaborator

Great improvement! Thanks.

@iloveitaly iloveitaly merged commit 93db513 into railwayapp:main May 30, 2026
229 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants