Ace Citizenship

Eine kostenlose iOS-App, die ich gebaut habe, um meiner Frau beim Bestehen ihres US-Staatsbuergerschaftstests zu helfen.

Ace Citizenship app interface

Zusammenfassung

Als meine Frau begann, sich auf ihren US-Einbuergerungstest vorzubereiten, konnte ich keine Lern-App finden, die meinen Standards entsprach.

Ace Citizenship deckt alle 128 offiziellen USCIS-Civics-Fragen mit Spaced Repetition ab.

Die App ist und bleibt vollstaendig kostenlos. Keine Werbung, keine Abonnements.

Die Entstehungsgeschichte

Ich habe Ace Citizenship fuer ein Publikum von einer Person gebaut: meine Frau.

Die vorhandenen Apps auf dem Markt waren enttaeuschend.

Ich wusste, dass ich es besser machen konnte.

Die App

Ace Citizenship bietet ein Premium-Erlebnis ohne den Premium-Preis. Die Oberflaeche ist klar, fokussiert und respektiert Ihre Zeit.

Welcome screen
Quiz interface
Completion screen
Settings screen

Visuelles Design

Ich habe eine zusammenhaengende 3D-Bildsprache geschaffen - traeumerisch, optimistisch, eindeutig amerikanisch.

Jede Illustration wurde in Midjourney mit benutzerdefinierten Prompts generiert, die ich ueber 100.000+ Bildgenerierungen verfeinert habe.

Mehr von meiner KI-generierten Kunst auf dreamofelectric.com. dreamofelectric.com.

3D flag
3D Capitol
3D States map

Spaced Repetition

Im Kern von Ace Citizenship steht ein Spaced-Repetition-Algorithmus, der Lernsitzungen optimiert.

Dieser evidenzbasierte Ansatz reduziert die Lernzeit drastisch bei gleichzeitiger Verbesserung der Merkfaehigkeit.

Die App verfolgt den Fortschritt und passt sich an individuelle Lernmuster an.

Personalisiertes Lernen

Einige USCIS-Fragen haben Antworten, die von Ihrer spezifischen Situation abhaengen.

Diese Liebe zum Detail bedeutet, dass Benutzer die genauen Informationen lernen, die sie am Pruefungstag brauchen.

USCIS questions reference

Technische Implementierung

Vollstaendig in SwiftUI fuer iOS gebaut, nutzt Ace Citizenship Apples moderne Frameworks voll aus.

Die Architektur ist wartbar und effizient.

Das Befolgen von Apples Human Interface Guidelines stellt sicher, dass sich die App nativ anfuehlt.

Unter der Haube

Einige interessante Muster aus der Codebasis, die die App effektiv machen.

Spaced-Repetition-Algorithmus

Die Kern-Lern-Engine priorisiert Fragen, mit denen Sie kaempfen.

Flashcards.swift
func completeCard(correct: Bool) {
    if !currentSet.isEmpty {
        let card = currentSet.removeFirst()
        remainingCards -= 1

        if correct {
            cards.append(card)  // Back to main deck
        } else {
            incorrectCards.append(card)  // Priority requeue
        }
    }
}

func prepareNextSet() {
    // Prioritize missed questions in next round
    let incorrectCount = min(incorrectCards.count, 10)
    let newCardsCount = 10 - incorrectCount

    currentSet = Array(incorrectCards.prefix(incorrectCount))
    incorrectCards.removeFirst(incorrectCount)
    currentSet += Array(cards.prefix(newCardsCount))
}

Staatsspezifische Personalisierung

Die App pflegt eine Datenbank aller 50 Staaten plus Territorien.

Questions.swift
struct StateInfo {
    let name: String
    let senators: [String]
    let governor: String
    let capital: String
}

// Updated for 119th Congress (January 2025)
let stateInformation: [String: StateInfo] = [
    "California": StateInfo(
        name: "California",
        senators: ["Adam Schiff", "Alex Padilla"],
        governor: "Gavin Newsom",
        capital: "Sacramento"
    ),
    // ... all 50 states + territories
]

Typsicheres Theming

Das Theming-System verwendet Swifts KeyPath-Funktion fuer Compile-Time-Sicherheit.

Theme.swift
struct Theme {
    struct ColorSet {
        let background: Color
        let surface: Color
        let onBackground: Color
        let blue: Color
        let green: Color
        let red: Color
    }

    static func color(
        _ keyPath: KeyPath<ColorSet, Color>,
        for colorScheme: ColorScheme
    ) -> Color {
        let colorSet = colorScheme == .dark
            ? darkMode
            : lightMode
        return colorSet[keyPath: keyPath]
    }
}

// Usage: Theme.color(\.blue, for: colorScheme)

Sie hat bestanden

Meine Frau benutzte Ace Citizenship, um sich auf ihren Einbuergerungstest vorzubereiten. Sie hat bestanden.

Dieser Moment machte jede Entwicklungsstunde lohnenswert.

Citizenship ceremony materials
Der Treueeid
Naturalization ceremony
Heute bin ich Amerikaner

Anderen helfen

Nach dem Erfolg meiner Frau habe ich Ace Citizenship im App Store veroeffentlicht. Es hat eine 5-Sterne-Bewertung erhalten.

Ein Benutzer schrieb: "Ich habe diese App einen Monat lang taeglich 30 Minuten genutzt und bestanden!"

Die App hilft weiterhin Einwanderern, ihr Ziel zu erreichen, US-Buerger zu werden.

Danksagung

Ace Citizenship repraesentiert, was ich am Softwareentwickeln liebe.

Dieses Projekt ermoeglichte es mir, ueber den gesamten Produktlebenszyklus zu arbeiten.

Die App ist und bleibt kostenlos.

Im App Store herunterladen →