Skip to content

Fastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows, iOS testflight! Android, Linux waitlist open! A local Wispr Flow alternative. Follow https://x.com/fluidvoiceapp for more

style(ui): redesign onboarding landing

altic-dev44be0a4672ac
diff --git a/Sources/Fluid/Resources/onboarding_welcome.m4a b/Sources/Fluid/Resources/onboarding_welcome.m4a
new file mode 100644
index 00000000..c1cc4737
Binary files /dev/null and b/Sources/Fluid/Resources/onboarding_welcome.m4a differ
diff --git a/Sources/Fluid/Services/OnboardingSoundPlayer.swift b/Sources/Fluid/Services/OnboardingSoundPlayer.swift
new file mode 100644
index 00000000..323c0f18
--- /dev/null
+++ b/Sources/Fluid/Services/OnboardingSoundPlayer.swift
@@ -0,0 +1,43 @@
+import AVFoundation
+import Foundation
+
+@MainActor
+final class OnboardingSoundPlayer {
+ static let shared = OnboardingSoundPlayer()
+
+ private var welcomePlayer: AVAudioPlayer?
+
+ private init() {}
+
+ func playWelcomeSound() {
+ let settings = SettingsStore.shared
+ guard settings.enableTranscriptionSounds, settings.transcriptionStartSound != .none else { return }
+ guard let url = Bundle.main.url(forResource: "onboarding_welcome", withExtension: "m4a") else {
+ DebugLogger.shared.error("Missing sound resource: onboarding_welcome.m4a", source: "OnboardingSoundPlayer")
+ return
+ }
+
+ let volume = min(settings.transcriptionSoundVolume, 0.55)
+ guard volume > 0.001 else { return }
+
+ do {
+ let player: AVAudioPlayer
+ if let existing = self.welcomePlayer {
+ player = existing
+ } else {
+ player = try AVAudioPlayer(contentsOf: url)
+ player.prepareToPlay()
+ self.welcomePlayer = player
+ }
+
+ player.currentTime = 0
+ player.volume = volume
+ player.play()
+ } catch {
+ DebugLogger.shared.error(
+ "Failed to play onboarding welcome sound: \(error.localizedDescription)",
+ source: "OnboardingSoundPlayer"
+ )
+ }
+ }
+}
diff --git a/Sources/Fluid/Theme/AppTheme.swift b/Sources/Fluid/Theme/AppTheme.swift
index 1ac927a5..3c8d48a6 100644
--- a/Sources/Fluid/Theme/AppTheme.swift
+++ b/Sources/Fluid/Theme/AppTheme.swift
@@ -43,8 +43,8 @@ struct AppTheme {
let chromeCaption: Font
static let standard = Typography(
- displayTitle: .system(size: 32, weight: .bold),
- statement: .system(size: 16, weight: .regular),
+ displayTitle: .system(size: 42, weight: .semibold),
+ statement: .system(size: 17, weight: .regular),
title: .system(size: 22, weight: .bold),
titleIcon: .system(size: 22, weight: .regular),
sectionTitle: .system(size: 15, weight: .semibold),
diff --git a/Sources/Fluid/Theme/Components/OnboardingComponents.swift b/Sources/Fluid/Theme/Components/OnboardingComponents.swift
index 2bf816a8..f9f72bbd 100644
--- a/Sources/Fluid/Theme/Components/OnboardingComponents.swift
+++ b/Sources/Fluid/Theme/Components/OnboardingComponents.swift
@@ -1,3 +1,4 @@
+import AppKit
import SwiftUI
struct FluidOnboardingLandingHero<Actions: View>: View {
@@ -5,143 +6,179 @@ struct FluidOnboardingLandingHero<Actions: View>: View {
let eyebrow: String
let title: String
- let statement: String
- let systemImage: String
+ let accentTitle: String
+ let firstDetail: String
+ let secondDetail: String
let actions: Actions
init(
eyebrow: String,
title: String,
- statement: String,
- systemImage: String,
+ accentTitle: String,
+ firstDetail: String,
+ secondDetail: String,
@ViewBuilder actions: () -> Actions
) {
self.eyebrow = eyebrow
self.title = title
- self.statement = statement
- self.systemImage = systemImage
+ self.accentTitle = accentTitle
+ self.firstDetail = firstDetail
+ self.secondDetail = secondDetail
self.actions = actions()
}
var body: some View {
- let landing = self.theme.metrics.onboardingSurface.landing
- let shape = RoundedRectangle(cornerRadius: landing.heroCornerRadius, style: .continuous)
-
- HStack(alignment: .center, spacing: self.theme.metrics.spacing.xl) {
- ZStack {
- Circle()
- .fill(self.theme.palette.accent.opacity(0.14))
- Image(systemName: self.systemImage)
- .font(.system(size: landing.heroIconSize, weight: .regular))
- .foregroundStyle(self.theme.palette.accent)
- }
- .frame(width: landing.heroIconFrame, height: landing.heroIconFrame)
- .accessibilityHidden(true)
+ VStack(spacing: 0) {
+ FluidOnboardingAppIconMark()
+ .padding(.bottom, self.eyebrow.isEmpty ? 40 : 26)
- VStack(alignment: .leading, spacing: self.theme.metrics.spacing.md) {
+ if !self.eyebrow.isEmpty {
Text(self.eyebrow)
- .font(self.theme.typography.captionStrong)
- .foregroundStyle(self.theme.palette.accent)
+ .font(.system(size: 14, weight: .bold))
+ .tracking(4.2)
+ .foregroundStyle(FluidOnboardingLandingColors.blue.opacity(0.72))
.textCase(.uppercase)
+ .padding(.bottom, 16)
+ }
+ VStack(spacing: 4) {
Text(self.title)
- .font(self.theme.typography.displayTitle)
- .foregroundStyle(self.theme.palette.primaryText)
- .fixedSize(horizontal: false, vertical: true)
-
- Text(self.statement)
- .font(self.theme.typography.statement)
- .foregroundStyle(.secondary)
- .fixedSize(horizontal: false, vertical: true)
+ .font(.system(size: 52, weight: .semibold))
+ .foregroundStyle(.white)
+ .multilineTextAlignment(.center)
+ .minimumScaleFactor(0.82)
+
+ Text(self.accentTitle)
+ .font(.system(size: 50, weight: .semibold))
+ .italic()
+ .foregroundStyle(FluidOnboardingLandingColors.blue)
+ .multilineTextAlignment(.center)
+ .minimumScaleFactor(0.76)
+ }
+ .lineLimit(1)
+ .shadow(color: .black.opacity(0.34), radius: 10, x: 0, y: 5)
+ .padding(.bottom, 28)
- self.actions
- .padding(.top, self.theme.metrics.spacing.sm)
+ VStack(spacing: 8) {
+ Text(self.firstDetail)
+ Text(self.secondDetail)
}
+ .font(.system(size: 22, weight: .medium))
+ .foregroundStyle(Color.white.opacity(0.70))
+ .multilineTextAlignment(.center)
+ .lineLimit(1)
+ .minimumScaleFactor(0.82)
+ .padding(.bottom, 42)
+
+ self.actions
}
- .padding(landing.heroPadding)
- .frame(maxWidth: .infinity, alignment: .leading)
- .background(
- shape
- .fill(self.theme.palette.elevatedCardBackground.opacity(0.72))
- .overlay(shape.stroke(self.theme.palette.cardBorder.opacity(0.26), lineWidth: 1))
- )
+ .padding(.horizontal, self.theme.metrics.onboardingSurface.landing.heroPadding)
+ .frame(maxWidth: .infinity, alignment: .center)
}
}
-struct FluidOnboardingValueTile: View {
- @Environment(\.theme) private var theme
+struct FluidOnboardingLandingBackdrop: View {
+ let glowCenter: UnitPoint
- let systemImage: String
- let title: String
- let description: String
+ init(glowCenter: UnitPoint = UnitPoint(x: 0.5, y: 0.18)) {
+ self.glowCenter = glowCenter
+ }
var body: some View {
- VStack(alignment: .leading, spacing: self.theme.metrics.spacing.sm) {
- Image(systemName: self.systemImage)
- .font(self.theme.typography.titleIcon)
- .foregroundStyle(self.theme.palette.accent)
- .accessibilityHidden(true)
-
- Text(self.title)
- .font(self.theme.typography.bodyStrong)
- .foregroundStyle(self.theme.palette.primaryText)
-
- Text(self.description)
- .font(self.theme.typography.caption)
- .foregroundStyle(.secondary)
- .fixedSize(horizontal: false, vertical: true)
+ ZStack {
+ Color(red: 0.012, green: 0.019, blue: 0.031)
+
+ RadialGradient(
+ colors: [
+ FluidOnboardingLandingColors.blue.opacity(0.18),
+ Color(red: 0.014, green: 0.032, blue: 0.068).opacity(0.30),
+ .clear,
+ ],
+ center: self.glowCenter,
+ startRadius: 0,
+ endRadius: 620
+ )
+
+ RadialGradient(
+ colors: [
+ Color.white.opacity(0.026),
+ .clear,
+ ],
+ center: .center,
+ startRadius: 0,
+ endRadius: 520
+ )
}
- .frame(maxWidth: .infinity, alignment: .topLeading)
- .fluidOnboardingSelectableSurface(isSelected: false)
+ .ignoresSafeArea()
}
}
-struct FluidOnboardingChecklistPanel<Rows: View>: View {
- @Environment(\.theme) private var theme
-
- let title: String
- let rows: Rows
-
- init(title: String, @ViewBuilder rows: () -> Rows) {
- self.title = title
- self.rows = rows()
- }
+private struct FluidOnboardingAppIconMark: View {
+ private static let appIconImage: NSImage = NSApplication.shared.applicationIconImage
+ ?? NSWorkspace.shared.icon(forFile: Bundle.main.bundlePath)
var body: some View {
- ThemedCard(style: .subtle) {
- VStack(alignment: .leading, spacing: self.theme.metrics.spacing.md) {
- Text(self.title)
- .font(self.theme.typography.sectionTitle)
- .foregroundStyle(self.theme.palette.primaryText)
-
- self.rows
- }
- .padding(16)
+ ZStack {
+ Circle()
+ .fill(FluidOnboardingLandingColors.blue.opacity(0.28))
+ .blur(radius: 42)
+ .frame(width: 188, height: 188)
+ .offset(y: -16)
+
+ FluidOnboardingPortalGlow()
+ .offset(y: 58)
+
+ Image(nsImage: Self.appIconImage)
+ .resizable()
+ .interpolation(.high)
+ .aspectRatio(contentMode: .fit)
+ .frame(width: 116, height: 116)
+ .shadow(color: Color.black.opacity(0.56), radius: 20, x: 0, y: 15)
+ .shadow(color: FluidOnboardingLandingColors.blue.opacity(0.58), radius: 36, x: 0, y: 0)
}
+ .frame(width: 360, height: 176)
+ .accessibilityHidden(true)
}
}
-struct FluidOnboardingChecklistRow: View {
- @Environment(\.theme) private var theme
-
- let systemImage: String
- let text: String
-
+private struct FluidOnboardingPortalGlow: View {
var body: some View {
- HStack(spacing: self.theme.metrics.spacing.sm) {
- Image(systemName: self.systemImage)
- .font(self.theme.typography.captionStrong)
- .foregroundStyle(self.theme.palette.accent)
- .frame(width: 18)
- .accessibilityHidden(true)
-
- Text(self.text)
- .font(self.theme.typography.bodySmall)
- .foregroundStyle(.secondary)
+ ZStack {
+ Ellipse()
+ .fill(
+ RadialGradient(
+ colors: [
+ Color.white.opacity(0.74),
+ FluidOnboardingLandingColors.blue.opacity(0.64),
+ FluidOnboardingLandingColors.blue.opacity(0.05),
+ .clear,
+ ],
+ center: .center,
+ startRadius: 0,
+ endRadius: 112
+ )
+ )
+ .blur(radius: 7)
+ .frame(width: 230, height: 25)
+
+ Ellipse()
+ .stroke(FluidOnboardingLandingColors.blue.opacity(0.42), lineWidth: 3)
+ .blur(radius: 1.4)
+ .frame(width: 326, height: 35)
+
+ Ellipse()
+ .stroke(FluidOnboardingLandingColors.blue.opacity(0.24), lineWidth: 1.4)
+ .frame(width: 260, height: 22)
}
}
}
+private enum FluidOnboardingLandingColors {
+ static let blue = Color(red: 0.10, green: 0.46, blue: 1.0)
+ static let buttonBlue = Color(red: 0.08, green: 0.43, blue: 1.0)
+ static let buttonBlueHighlight = Color(red: 0.24, green: 0.58, blue: 1.0)
+}
+
private struct OnboardingSelectableSurfaceModifier: ViewModifier {
@Environment(\.theme) private var theme
let isSelected: Bool
@@ -214,6 +251,53 @@ private struct OnboardingProminentButtonModifier: ViewModifier {
}
}
+private struct OnboardingGlowButtonModifier: ViewModifier {
+ @Environment(\.theme) private var theme
+ @State private var isHovered = false
+
+ let controlSize: ControlSize?
+
+ func body(content: Content) -> some View {
+ let isLarge = self.controlSize == .large
+
+ content
+ .font(.system(size: isLarge ? 18 : 14, weight: .semibold))
+ .foregroundStyle(Color.white)
+ .padding(.horizontal, isLarge ? 52 : 24)
+ .padding(.vertical, isLarge ? 15 : 9)
+ .frame(minWidth: isLarge ? 236 : 0)
+ .background(
+ Capsule()
+ .fill(
+ LinearGradient(
+ colors: [
+ FluidOnboardingLandingColors.buttonBlueHighlight,
+ FluidOnboardingLandingColors.buttonBlue,
+ ],
+ startPoint: .top,
+ endPoint: .bottom
+ )
+ )
+ .shadow(
+ color: FluidOnboardingLandingColors.blue.opacity(self.isHovered ? 0.56 : 0.34),
+ radius: self.isHovered ? 24 : 16,
+ x: 0,
+ y: 8
+ )
+ )
+ .overlay(
+ Capsule()
+ .stroke(Color.white.opacity(0.24), lineWidth: 1)
+ )
+ .contentShape(Capsule())
+ .buttonStyle(.plain)
+ .onHover { hovering in
+ self.isHovered = hovering
+ }
+ .animation(.easeOut(duration: 0.16), value: self.isHovered)
+ }
+}
+
private struct OnboardingSecondaryButtonModifier: ViewModifier {
let controlSize: ControlSize?
@@ -253,6 +337,10 @@ extension View {
self.modifier(OnboardingProminentButtonModifier(controlSize: controlSize))
}
+ func fluidOnboardingGlowButton(controlSize: ControlSize? = nil) -> some View {
+ self.modifier(OnboardingGlowButtonModifier(controlSize: controlSize))
+ }
+
func fluidOnboardingSecondaryButton(controlSize: ControlSize? = nil) -> some View {
self.modifier(OnboardingSecondaryButtonModifier(controlSize: controlSize))
}
diff --git a/Sources/Fluid/UI/WelcomeView.swift b/Sources/Fluid/UI/WelcomeView.swift
index 58e51387..69c74442 100644
--- a/Sources/Fluid/UI/WelcomeView.swift
+++ b/Sources/Fluid/UI/WelcomeView.swift
@@ -575,6 +575,7 @@ struct WelcomeView: View {
struct OnboardingFlowView: View {
@EnvironmentObject var appServices: AppServices
+ @Environment(\.accessibilityReduceMotion) private var reduceMotion
private var asr: ASRService { self.appServices.asr }
@ObservedObject private var settings = SettingsStore.shared
@@ -589,6 +590,10 @@ struct OnboardingFlowView: View {
let theme: AppTheme
@State private var preferredLanguageChoice: PreferredLanguageChoice = .englishOnly
+ @State private var hasPlayedLandingWelcomeSound = false
+ @State private var landingGlowCenter = UnitPoint(x: 0.5, y: 0.18)
+ @State private var lastLandingGlowLocation = CGPoint(x: -1000, y: -1000)
+ private let landingGlowMovementThreshold: CGFloat = 24
private enum PreferredLanguageChoice: String, CaseIterable, Identifiable {
case englishOnly
@@ -858,11 +863,15 @@ struct OnboardingFlowView: View {
}
.onAppear {
self.syncPreferredLanguageChoiceWithSelectedModel()
+ self.playLandingWelcomeSoundIfNeeded()
Task { @MainActor in
self.asr.micStatus = AVCaptureDevice.authorizationStatus(for: .audio)
await self.asr.checkIfModelsExistAsync()
}
}
+ .onChange(of: self.currentStep) { _, _ in
+ self.playLandingWelcomeSoundIfNeeded()
+ }
.onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
self.asr.micStatus = AVCaptureDevice.authorizationStatus(for: .audio)
}
@@ -913,62 +922,78 @@ struct OnboardingFlowView: View {
}
private var landingStep: some View {
- ScrollView {
- let landing = self.theme.metrics.onboardingSurface.landing
- let tileWidth = (landing.contentWidth - (landing.tileSpacing * 2)) / 3
- let tileColumns = Array(
- repeating: GridItem(.fixed(tileWidth), spacing: landing.tileSpacing, alignment: .top),
- count: 3
- )
-
- VStack(alignment: .leading, spacing: self.theme.metrics.onboardingSurface.landing.sectionSpacing) {
- FluidOnboardingLandingHero(
- eyebrow: "FluidVoice",
- title: "Say it once. Use it anywhere.",
- statement: "FluidVoice turns your speech into clean, ready-to-use text across your Mac, with local dictation first and optional AI polish when you want it.",
- systemImage: "waveform.and.mic"
- ) {
- Button("Get Started") {
- self.goNext()
+ GeometryReader { proxy in
+ ScrollView {
+ let landing = self.theme.metrics.onboardingSurface.landing
+
+ VStack(alignment: .center, spacing: self.theme.metrics.onboardingSurface.landing.sectionSpacing) {
+ FluidOnboardingLandingHero(
+ eyebrow: "",
+ title: "Just speak.",
+ accentTitle: "We'll handle the rest.",
+ firstDetail: "Accurate. Fast. Private. Free.",
+ secondDetail: "Built for creators, thinkers, and builders."
+ ) {
+ Button("Next") {
+ self.goNext()
+ }
+ .fluidOnboardingGlowButton(controlSize: .large)
+ .keyboardShortcut(.defaultAction)
}
- .fluidOnboardingProminentButton(controlSize: .large)
- .keyboardShortcut(.defaultAction)
- }
-
- LazyVGrid(
- columns: tileColumns,
- alignment: .leading,
- spacing: self.theme.metrics.onboardingSurface.landing.tileSpacing
- ) {
- FluidOnboardingValueTile(
- systemImage: "keyboard",
- title: "Types where you work",
- description: "Dictate into Notes, browsers, chat, docs, and editors."
- )
- FluidOnboardingValueTile(
- systemImage: "lock",
- title: "Local-first setup",
- description: "Prepare a voice model once and keep core dictation on your Mac."
- )
- FluidOnboardingValueTile(
- systemImage: "wand.and.stars",
- title: "Cleaner drafts",
- description: "Turn rough speech into polished text when enhancement is enabled."
- )
}
-
- FluidOnboardingChecklistPanel(title: "Setup takes a few minutes") {
- FluidOnboardingChecklistRow(systemImage: "cpu", text: "Choose and prepare a voice model")
- FluidOnboardingChecklistRow(systemImage: "mic", text: "Allow microphone access")
- FluidOnboardingChecklistRow(systemImage: "keyboard.badge.eye", text: "Allow FluidVoice to type into apps")
- FluidOnboardingChecklistRow(systemImage: "text.bubble", text: "Run one quick test")
+ .frame(width: landing.contentWidth, alignment: .center)
+ .frame(maxWidth: .infinity)
+ .frame(minHeight: proxy.size.height, alignment: .center)
+ .offset(y: -78)
+ .padding(.horizontal, 24)
+ .padding(.vertical, 24)
+ }
+ .defaultScrollAnchor(.center)
+ .contentShape(Rectangle())
+ .onContinuousHover { phase in
+ switch phase {
+ case let .active(location):
+ self.updateLandingGlow(location: location, in: proxy.size)
+ case .ended:
+ self.resetLandingGlow()
}
}
- .frame(width: landing.contentWidth, alignment: .leading)
- .frame(maxWidth: .infinity)
- .padding(24)
+ .background {
+ FluidOnboardingLandingBackdrop(glowCenter: self.landingGlowCenter)
+ }
}
- .defaultScrollAnchor(.center)
+ }
+
+ private func updateLandingGlow(location: CGPoint, in size: CGSize) {
+ guard !self.reduceMotion else { return }
+ guard location.x.isFinite, location.y.isFinite, size.width > 0, size.height > 0 else { return }
+
+ let dx = location.x - self.lastLandingGlowLocation.x
+ let dy = location.y - self.lastLandingGlowLocation.y
+ guard (dx * dx) + (dy * dy) > (self.landingGlowMovementThreshold * self.landingGlowMovementThreshold) else { return }
+
+ self.lastLandingGlowLocation = location
+ let normalizedX = min(max(location.x / size.width, 0), 1)
+ let normalizedY = min(max(location.y / size.height, 0), 1)
+
+ withAnimation(.easeOut(duration: 0.22)) {
+ self.landingGlowCenter = UnitPoint(x: normalizedX, y: normalizedY)
+ }
+ }
+
+ private func resetLandingGlow() {
+ guard !self.reduceMotion else { return }
+ self.lastLandingGlowLocation = CGPoint(x: -1000, y: -1000)
+
+ withAnimation(.easeOut(duration: 0.35)) {
+ self.landingGlowCenter = UnitPoint(x: 0.5, y: 0.18)
+ }
+ }
+
+ private func playLandingWelcomeSoundIfNeeded() {
+ guard self.step == .landing, !self.hasPlayedLandingWelcomeSound else { return }
+ self.hasPlayedLandingWelcomeSound = true
+ OnboardingSoundPlayer.shared.playWelcomeSound()
}
private var voiceModelStep: some View {