pkl

= image:.idea/icon.svg[Pkl,30] Pkl

:uri-homepage: https://pkl-lang.org
:uri-docs: {uri-homepage}/main/current
:uri-docs-introduction: {uri-docs}/introduction
:uri-docs-release-notes: {uri-docs}/release-notes
:uri-docs-language: {uri-docs}/language
:uri-docs-tools: {uri-docs}/tools
:uri-github-issue: https://github.com/apple/pkl/issues
:uri-github-discussions: https://github.com/apple/pkl/discussions
:uri-pkl-examples: https://pkl-lang.org/main/current/examples.html
:uri-installation: https://pkl-lang.org/main/current/pkl-cli/index.html#installation
:uri-lang-reference: https://pkl-lang.org/main/current/language-reference/index.html
:uri-ci-artifacts: https://s01.oss.sonatype.org/content/groups/public/org/pkl-lang/
:uri-ci-pipeline: https://app.circleci.com/pipelines/github/apple/pkl

A configuration as code language with rich validation and tooling.

== Quick Links

• {uri-installation}[Installation]
• {uri-lang-reference}[Language Reference]

== Documentation

• {uri-homepage}[Home Page]
  ** {uri-docs-introduction}[Introduction]
  ** {uri-docs-language}[Language]
  ** {uri-docs-tools}[Tools]
  ** {uri-pkl-examples}[Examples]
  ** {uri-docs-release-notes}[Release Notes]

== Community

We’d love to hear from you!

• Create an {uri-github-issue}[issue]
• Ask a question on {uri-github-discussions}[GitHub Discussions]

== Development image:https://circleci.com/gh/apple/pkl.svg?style=svg[“Apple”, link=“https://app.circleci.com/pipelines/github/apple/pkl”]

• link:CONTRIBUTING.adoc[] for tips on pull requests and filing issues
• link:DEVELOPMENT.adoc[] for build instructions
• {uri-ci-artifacts}[Sonatype Repository] for the artifacts/binaries built by our {uri-ci-pipeline}[CI pipelines] (and those of our other tools and packages repositories).

== Pkl GitHub Repositories

[%autowidth]
|===
|Name |Description

|apple/pkl
|A configuration as code language with rich validation and tooling.

|https://github.com/apple/pkl-evolution[apple/pkl-evolution]
|Suggested Pkl Improvements, Changes, or Enhancements (SPICEs)

|https://github.com/apple/pkl-go[apple/pkl-go]
|Pkl bindings for the Go programming language

|https://github.com/apple/pkl-go-examples[apple/pkl-go-examples]
|Examples for using Pkl within Go applications

|https://github.com/apple/pkl-intellij[apple/pkl-intellij]
|JetBrains editor plugins providing Pkl language support

|https://github.com/apple/pkl-jvm-examples[apple/pkl-jvm-examples]
|Examples for using Pkl within JVM applications

|https://github.com/apple/pkl-k8s[apple/pkl-k8s]
|Templates for using Pkl with Kubernetes

|https://github.com/apple/pkl-k8s-examples[apple/pkl-k8s-examples]
|Examples for using Pkl with Kubernetes

|https://github.com/apple/pkl-lang.org[apple/pkl-lang.org]
|The pkl-lang.org website

|https://github.com/apple/pkl-lsp[apple/pkl-lsp]
| Language server for Pkl, implementing the server-side of the Language Server Protocol

|https://github.com/apple/pkl-neovim[apple/pkl-neovim]
|Pkl language support for Neovim

|https://github.com/apple/pkl-package-docs[apple/pkl-package-docs]
|Documentation for Pkl packages

|https://github.com/apple/pkl-pantry[apple/pkl-pantry]
|Shared Pkl packages

|https://github.com/apple/pkl-project-commons[apple/pkl-project-commons]
|Utility libraries for Pkl

|https://github.com/apple/pkl-spring[apple/pkl-spring]
|Spring Boot extension for configuring Boot apps with Pkl

|https://github.com/apple/pkl-swift[apple/pkl-swift]
|Pkl bindings for the Swift programming language

|https://github.com/apple/pkl-swift-examples[apple/pkl-swift-examples]
|Examples for using Pkl within Swift applications

|https://github.com/apple/pkl-vscode[apple/pkl-vscode]
|Pkl language support for VS Code

|https://github.com/apple/pkl.tmbundle[apple/pkl.tmbundle]
|TextMate bundle for Pkl

|https://github.com/apple/rules_pkl[apple/rules_pkl]
| Bazel build rules for Pkl

|https://github.com/apple/tree-sitter-pkl[apple/tree-sitter-pkl]
|Tree-sitter parser for Pkl
|===