Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/johngarrett/HyperSwift

A Swift DSL for generating HTML and CSS documents
https://github.com/johngarrett/HyperSwift

dsl html swift swiftpm

Last synced: about 1 month ago
JSON representation

A Swift DSL for generating HTML and CSS documents

Awesome Lists containing this project

README

        

## HyperSwift - a HTML and CSS Generator
[![Swift 5.2](https://img.shields.io/badge/swift-5.2-ED523F.svg?style=flat)](https://swift.org/download/)
[![@garrepi](https://img.shields.io/badge/[email protected]?style=flat)](https://twitter.com/garrepi)

#### About
HyperSwift (name pending) is a DSL written purely in Swift aimed to generate HTML styled with CSS.
#### Main Features
- Vertical and Horizontal stack wrappers
- Native HTML Elements
- CSS Stylesheet generation
#### Code Snippits
505 Page from [garrepi.dev](https://www.garrepi.dev):
```swift
import HyperSwift

VStack(justify: .center, align: .center) {
HStack(justify: .spaceEvenly, align: .center) {
Image(url: "/images/error_bomb.png")
.width(100)
.height(100)
Header(.header3) { "HTTP 500" }
.font(weight: "bold", size: 40, family: "SF Mono")
}
Paragraph(fiveOfiveMessage)
}
.backgroundColor(GColors.lightRed)
.textAlign(.center)
.margin(5, .percent)
.display(.flex)
.shadow(x: 20, y: 30, color: GColors.cardShadow)
.border(width: 1, color: .black)
```
![output](https://media.discordapp.net/attachments/732426870100066455/733822598504513566/unknown.png)

#### CSS

To add CSS to the stylesheet, you have to call one of the functions defined in [CSSExtensions.swift](/Sources/HyperSwift/API/CSS/CSSExtensions.swift).
If an element has a class name, the styles will automatically be added to [CSSStyleSheet.swift](/Sources/HyperSwift/API/CSS/CSSStyleSheet.swift)'s stylesheet.
Calling `.generateStyleSheet()` on [CSSStyleSheet.swift](/Sources/HyperSwift/API/CSS/CSSStyleSheet.swift) will return a string containing the stylesheet.

#### Examples

HyperSwift is being used on [garrepi.dev](https://www.garrepi.dev) as we speak! Checkout the source code [here](https://github.com/johngarrett/garrepi.dev/).

#### Usage

in your `Package.swift`:
```swift
. . .
.package(url: "https://github.com/johngarrett/HyperSwift", .branch("main")),
. . .
```

#### Contributing

I would _love_ help with this -- there's a lot that needs to get done.

I have little free time and an even little-er ability to focus on one project. Feel free to send in a PR with ideas, suggestions, or actual code!

reach out to me on [twitter](https://twitter.com/garrepi) if you have questions I can answer