With IBM discontinuing its involvement in server-side Swift, we are choosing to deprecate support for this library. It will remain in an archived state as an example of how to integrate with swift-html.
[
](https://trav is-ci.org/pointfreeco/swift-html-kitura)
Kitura plugin for type-safe, transformable HTML views using swift-html.
The most popular choice for rendering HTML in a Kitura web app is to use the Stencil templating language, but it exposes your application to runtime errors and invalid HTML. Our plugin prevents these runtime issues at compile-time by embedding HTML directly into Swift’s powerful type system. It uses the swift-html DSL for constructing HTML documents using plain Swift data structures.
To use the plugin all you have to do is return a Node
value from your router callback:
import HtmlKituraSupport
import Kitura
let router = Router()
router.get("/") { request, response, next in
response.send(
Node.h1("Hello, type-safe HTML on Kitura!")
)
next()
}
Kitura.addHTTPServer(onPort: 8080, with: router)
Kitura.run()
We've included a sample Kitura application in this repo to show off its usage. To run the app immediately, simply do:
swift run HtmlKituraSupportExample
- Open your browser to
http://localhost:8080
The HTML for that page is constructed and rendered with swift-html!
If you want to run the app in Xcode so that you can play around with the HTML, try this:
git clone https://github.com/pointfreeco/swift-html-kitura
cd swift-html-kitura
make xcodeproj
- Select the
HtmlKituraSupportExample
target - Build and run
cmd+R
- Open your browser to
http://localhost:8080
If you want to use swift-html-kitura in a project that uses SwiftPM, it's as simple as adding a dependencies
clause to your Package.swift
:
dependencies: [
.package(url: "https://github.com/pointfreeco/swift-html-kitura.git", from: "0.3.0")
]
Submodule, clone, or download swift-html-kitura, and drag HtmlKituraSupport.xcodeproj
into your project.
All modules are released under the MIT license. See LICENSE for details.