Vapor plugin for type-safe, transformable HTML views using swift-html.
The most popular choice for rendering HTML in a Vapor web app is to use the Leaf 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 HtmlVaporSupport
import Vapor
var env = try Environment.detect()
let app = Application(env)
defer { app.shutdown() }
app.get { _ in
Node.h1("Hello, type-safe HTML on Vapor!")
}
try app.run()We've included a sample Vapor application in this repo to show off its usage. To run the app immediately, simply do:
swift run HtmlVaporSupportExample- 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-vaporcd swift-html-vapormake xcodeproj- Select the
HtmlVaporSupportExampletarget - Build and run
cmd+R - Open your browser to
http://localhost:8080
If you want to use swift-html-vapor 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-vapor", from: "0.4.0")
]All modules are released under the MIT license. See LICENSE for details.