Swish is a domain-specific language for writing type-safe CSS in Swift and best used for small, simple websites. Swish shines when combined with other Swift solutions for web development such as Vapor, Plot and Publish.
✍️ Writing CSS in Swift
Swish allows you to write CSS using expressive Swift code with type-safe builders to help reduce mistakes and make code easier to read and understand:
let css = CSS( .class("home-header", .position(.relative), .width(.pc(100)), .height(.auto), .padding(.px(32)), .textAlign(.center) ), .selector("body", .background( color: .hex(0x000000) ) ) )
The above should look pretty recognizable if you've ever used CSS before. Swish property builder functions map to CSS, but they also remove the need to specify all values for some properties. Take padding for example, normally we would have to specify
16px 0px 0px 16px if we wanted to change a
left value. With Swish you can simply specify
.padding(top: .px(16), left: .px(16)) and it'll fill in the blanks.
🤔 Using Unsupported Properties
Swish doesn't support all CSS properties natively (yet), but if there is a property you wish to use then you can use the
.raw builder to inject your own property name and value. Here's an example of how we would add an unsupported
let css = CSS( .class("container", .raw(property: "border", value: "2px solid red") ) )
- ☐ Provide further CSS property coverage
- ☐ Add tests
- ☐ Add internal documentation