Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 4 months ago
JSON representation
A Swift DSL for generating HTML and CSS documents
- Host: GitHub
- URL: https://github.com/johngarrett/HyperSwift
- Owner: johngarrett
- License: gpl-3.0
- Created: 2020-07-17T22:44:15.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-05-12T18:40:04.000Z (almost 3 years ago)
- Last Synced: 2024-10-30T17:25:03.639Z (4 months ago)
- Topics: dsl, html, swift, swiftpm
- Language: Swift
- Homepage:
- Size: 78.1 KB
- Stars: 48
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-result-builders - HyperSwift - A Swift DSL for generating HTML and CSS documents (HTML)
README
## HyperSwift - a HTML and CSS Generator
[](https://swift.org/download/)
[](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 HyperSwiftVStack(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)
```
#### 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