fhswiftui 0.0.5

SwiftUI inspired wrapper for FastHTML

fhswiftui

fhswiftui is a SwiftUI inspired wrapper for FastHTML and tailwind. fhswiftui is built on top of FastHTML and tailwind and will work with all FT components. Tailwind classes and FastHTML features work seamlessly.

FastHTML enables composing HTML apps by nested Python objects and tailwind is a CSS framework that provides standard CSS components. Since tailwind relies heavily on CSS classes to define components as well as include style information, this can quickly become complex and difficult to read.

For example, let’s consider a simple example of a turn in a chat which displays a user’s message with a timestamp. In FastHTML + tailwind, this would look like something:

Section(
    Div(
        Span('04:30:56', cls='text-xs text-muted-foreground'),
        Div('What is the meaning of life?', cls='flex w-max max-w-[75%] flex-col gap-2 rounded-lg px-3 py-2 text-sm border-l-4 border-primary italic'),
        cls='flex gap-2 items-center'
    ),
    cls='space-y-6'
)

fhswiftui provides layout and UI components. It also provides property setters that enable specific styling. The same example above using fhswiftui:

HStack(alignment="center")(
    Text('04:30:56').fg("muted-foreground").font(size="xs"),
    VDivider(border_color),
    Div(t.m).padding(left=3, right=3, top=2, bottom=2).font(size="sm")
)

fhswiftui is built on top of FastHTML and tailwind and will work with all FT components. Tailwind classes and FastHTML features work seamlessly.

Installation

Install latest from pypi

$ pip install fhswiftui

Why build yet another toolkit

Tailwind CSS gets complicated quickly

This slightly more comprhensive demo illustrates how per element classes can explode quickly and become difficult to read.

<div class="flex flex-col items-start gap-6 p-6">
  <div class="flex flex-row items-start gap-4 p-4 bg-gray-50 rounded shadow">
    <div class="flex flex-col items-start gap-1">
<span class="text-2xl font-bold">fhswiftui Demo</span><span class="text-sm font-normal text-gray-500">SwiftUI-inspired layouts with Basecoat styling</span>    </div>
    <div class="flex-grow"></div>
<button class="btn btn-outline btn-sm">Settings</button>  </div>
  <div class="flex flex-row items-start gap-4">
    <article class="card">
      <header>
        <h3 class="font-semibold">Typography</h3>
      </header>
      <section>
        <div class="flex flex-col items-start gap-2">
          <span class="text-2xl font-bold">Title</span>
          <span class="text-xl font-semibold">Headline</span>
          <span class="text-base font-normal">Body text goes here</span>
          <span class="text-sm font-normal text-gray-300">Caption for details</span>
          <span class="text-xs font-normal text-gray-500">Footnote</span>        
        </div>
      </section>
    </article>
    <article class="card">
      <header>
        <h3 class="font-semibold">Form Controls</h3>
      </header>
      <section>
        <div class="flex flex-col items-start gap-3">
          <div class="field">
            <label class="label">Email</label>            
            <input name="email" placeholder="[e-mail]" class="input">
          </div>
          <div class="field">
            <label class="label">Password</label>            
            <input name="password" placeholder="••••••••" type="password" class="input">
          </div>
          <div class="flex flex-row items-start gap-2">
            <button class="btn btn-outline">Cancel</button><button class="btn btn-primary">Submit</button>          
          </div>
        </div>
      </section>
    </article>
  </div>
  <div class="flex flex-row items-start gap-3">
    <span class="badge">Active</span><span class="badge badge-destructive">Error</span>  
  </div>
  <div class="border-t w-full my-2"></div>
  <span class="text-xl font-semibold">Semantic Colors</span>  
  <div class="flex flex-row items-start gap-2">
    <span class="text-gray-900">Primary</span>
    <span class="text-gray-500">Secondary</span>
    <span class="text-blue-600">Accent</span>
    <span class="text-green-600">Success</span>
    <span class="text-amber-500">Warning</span>
    <span class="text-red-600">Danger</span>  
  </div>
</div>

Using semantic expressions preserves readablity

By using semantic expressions, this preserves the intent of the designer. Changes become safer.

Notice, that we coexist with FastHTML so it is always possible to dive into raw Tailwind CSS if needed.

We believe, this encourages composiblity. Real world applications would define components that could be composed together in a light scaffolding.

from fasthtml.components import *
from fhswiftui import *


p = mk_previewer()

html = VStack(spacing=6)(
    
    HStack(spacing=4)(
        VStack(spacing=1)(
            Text("fhswiftui Demo").font(Font.Title),
            Text("SwiftUI-inspired layouts with Basecoat styling").font(Font.Caption).fg(Color.Secondary),
        ),
        Spacer(),
        Button("Settings", cls="btn btn-outline btn-sm"),
    ).padding().bg(Color.Surface).corner_radius().shadow(),
    
    # Feature showcase in cards
    HStack(spacing=4)(        
        Article(cls="card")(
            Header(H3("Typography", cls="font-semibold")),
            Section(
                VStack(spacing=2)(
                    Text("Title").font(Font.Title),
                    Text("Headline").font(Font.Headline),
                    Text("Body text goes here").font(Font.Body),
                    Text("Caption for details").font(Font.Caption).fg(Color.Muted),
                    Text("Footnote").font(Font.Footnote).fg(Color.Secondary),
                )
            )
        ),
        
        # Card 2: Form elements
        Article(cls="card")(
            Header(H3("Form Controls", cls="font-semibold")),
            Section(
                VStack(spacing=3)(
                    Div(cls="field")(
                        Label("Email", cls="label"),
                        TextField("email", placeholder="[e-mail]", cls="input"),
                    ),
                    Div(cls="field")(
                        Label("Password", cls="label"),
                        TextField("password", placeholder="••••••••", type="password", cls="input"),
                    ),
                    HStack(spacing=2)(
                        Button("Cancel", cls="btn btn-outline"),
                        Button("Submit", cls="btn btn-primary"),
                    ),
                )
            )
        ),
    ),
    
    # Status row
    HStack(spacing=3)(
        Span("Active", cls="badge"),
        Span("Error", cls="badge badge-destructive"),
    ),
    
    # Divider
    HDivider(),
    
    # Color palette showcase
    Text("Semantic Colors").font(Font.Headline),
    HStack(spacing=2)(
        Text("Primary").fg(Color.Primary),
        Text("Secondary").fg(Color.Secondary),
        Text("Accent").fg(Color.Accent),
        Text("Success").fg(Color.Success),
        Text("Warning").fg(Color.Warning),
        Text("Danger").fg(Color.Danger),
    ),
).padding(6)

p(html)