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: 8 days 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 (over 2 years ago)
• Last Synced: 2024-10-30T17:25:03.639Z (11 days 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

[![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