Platform Capabilities
CodeSleuth builds production-ready software for every major platform — web, desktop, and mobile. The pipeline detects your target platform from the project brief and surfaces the correct toolchain, signing requirements, and quality gates automatically.
Platform Capability Overview
Every platform CodeSleuth supports — primary toolchain, distribution model, signing requirements, and build host constraints at a glance.
| Platform | Primary Stack | Alt Stacks | Distribution | Signing | Build Host | Offline |
|---|---|---|---|---|---|---|
| 🌐 Web | Next.js 15, React 19, TypeScript | Remix, Vite SPA, Nuxt | Vercel, Cloudflare, self-host | TLS only | Any OS | ✗ |
| 🐧 Linux | GTK4 / libadwaita + Rust | Tauri, Python/PySide6, Electron | .deb, .rpm, Flatpak, AppImage | ⚠ Flatpak only | Linux or CI | ✓ |
| 🪟 Windows | WinUI 3 / .NET 8 | Tauri, Electron, C++ Win32 | MSIX, .exe installer, MS Store | Authenticode | Windows or CI | ✓ |
| 🍎 macOS | Swift / SwiftUI | Tauri, Electron, Objective-C | Mac App Store, direct .dmg | Apple notarization | ⚠ macOS only | ✓ |
| 🤖 Android | Kotlin + Jetpack Compose | Flutter, React Native, Capacitor | Google Play, APK sideload | Keystore signing | Any OS | ✓ |
| 📱 iOS | Swift / SwiftUI | Flutter, React Native, Capacitor | App Store, TestFlight | Apple signing + profiles | ⚠ macOS + Xcode only | ✓ |
Native vs Cross-Platform
When to use a platform-native stack versus a shared codebase — and what you trade off in each direction.
| Factor | Native (platform-specific) | Cross-Platform (Tauri / Flutter / RN) |
|---|---|---|
| Performance | ✓ Best — direct OS API access | Good for most apps; JS bridge overhead for heavy compute |
| UX fidelity | ✓ Platform conventions baked in | Requires extra effort to match platform feel |
| Code reuse | Separate codebases per platform | ✓ 70–95% shared codebase |
| Team size | Separate expertise per platform | ✓ Single team, one stack |
| Platform API access | ✓ Full, immediate | Mediated via plugins; newer APIs lag by months |
| App store acceptance | ✓ Low risk — follows platform guidelines | Higher risk — webview apps sometimes rejected |
| Best for | Single-platform, performance-critical, deep OS integration | Multi-platform launch, web-first teams, MVP speed |
Consumer apps targeting 2+ platforms: start with Tauri (desktop) or Flutter (mobile). Professional / enterprise tools where platform feel matters: go native. Web-first with desktop/mobile packaging: Next.js, then wrap with Tauri or Capacitor.
Host OS → Build Target Matrix
What you can build depends on the machine you're on. CI entries assume a hosted runner with the noted environment.
| Build Target | Linux host | Windows host | macOS host | Linux CI | macOS CI | Windows CI |
|---|---|---|---|---|---|---|
| 🌐 Web | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 🐧 Linux | ✓ Native | ✗ | ✗ | ✓ | ✗ | ✗ |
| 🪟 Windows | ✗ | ✓ Native | ✗ | ✗ | ✗ | ✓ |
| 🍎 macOS (unsigned) | ✗ | ✗ | ✓ | ✗ | ✓ | ✗ |
| 🍎 macOS (notarized) | ✗ | ✗ | ✓ + Apple ID | ✗ | ✓ + secrets | ✗ |
| 🤖 Android | ✓ (Android SDK) | ✓ (Android SDK) | ✓ (Android SDK) | ✓ | ✓ | ✓ |
| 📱 iOS (unsigned) | ✗ | ✗ | ✓ | ✗ | ✓ | ✗ |
| 📱 iOS (App Store) | ✗ | ✗ | ✓ + Apple Developer | ✗ | ✓ + secrets | ✗ |
Apple's toolchain (Xcode, codesign, notarytool) runs only on macOS. There is no Linux or Windows workaround for signed Apple builds. Use GitHub Actions macos-latest runners when you need CI for Apple targets.
Per-Platform Details
Full toolchain, packaging, and build details for each platform. Use the filter pills above to narrow the view.
The default CodeSleuth target. Full-stack Next.js with App Router, React Server Components, and Vercel or self-hosted deployment. Design contract auto-activated.
Native Linux desktop with GNOME/KDE-compatible UI. GTK4/libadwaita for a truly native feel; Tauri for web-tech UI with a Rust backend; PySide6 for data/science tooling.
First-class Windows app using WinUI 3 with Fluent Design, .NET 8, and MSIX packaging. Tauri is the cross-platform alternative when sharing logic with a Linux target.
Native macOS with Swift/SwiftUI and full platform integration — menu bar, Spotlight, iCloud, Handoff. Tauri for cross-platform desktop without native UI requirements.
Modern Android with Jetpack Compose and Material 3. Flutter for cross-platform with iOS. React Native for teams already in the JS ecosystem. Keystore signing required for Play Store.
iOS-native with Swift and SwiftUI. Shares a codebase with macOS targets when using SwiftUI. Flutter is the recommended cross-platform option. Requires Apple Developer Program membership ($99/yr).
Can I Build This From My Machine?
Select your OS, target platform, and distribution goal to see an instant compatibility check.
Recommended Workflows
Four proven starting configurations for common project types.
Build & Verification Gates Per Platform
What the Verifier (Agent 6) checks for each platform before issuing a SHIP or NO-SHIP verdict.
pnpm buildexits zero — no TypeScript errors, no bundle warnings- Total bundle ≤ 500 KB, initial chunk ≤ 200 KB (per
PERF_BUDGET.json) - API p50 ≤ 200ms, p95 ≤ 800ms across all declared endpoints
- Playwright E2E tests pass at desktop-1440, tablet-1024, mobile-768, mobile-390
- Visual regression diffs within threshold vs. stored baselines
- Zod schemas validate against actual API response fixtures
- OpenAPI stubs match implemented route handlers
- WCAG 2.1 AA automated axe-core scan passes
- No secrets in codebase —
.envaudit clean - Design contract conformance ≥ 90% (Inter font, brand colors, shadcn/ui)
cargo build --release(Rust) orpython -m build(Python) exits zerocargo testorpytest— all tests passcargo clippy -- -D warningsorruff check .— zero lint errors- AppImage or .deb package builds and installs cleanly on Ubuntu 22.04 LTS
- App launches from packaged binary without additional system dependencies
- No hardcoded absolute paths — respects XDG base directories
- Config stored under
$XDG_CONFIG_HOME, data under$XDG_DATA_HOME - GTK theme respects system dark/light mode preference
dotnet build -c Releaseexits zero — zero warnings in Release modedotnet test— all tests pass- MSIX package builds and installs cleanly on Windows 11
- Authenticode signature applied — no SmartScreen block on clean install
- App passes Windows App Certification Kit (WACK) if targeting Microsoft Store
- Config stored under
%APPDATA%, not the installation directory - High-DPI scaling tested at 100%, 125%, 150%, 200% system DPI
- Dark mode respects system
AppsUseLightThemeregistry value
xcodebuild -configuration Releaseexits zero- All XCTest and Swift Testing targets pass
- App bundle signed with Developer ID certificate
- Notarized via
xcrun notarytool— passes Apple's automated scan - Stapled ticket attached:
xcrun stapler staple - App launches from quarantined .dmg without Gatekeeper block
- Privacy permission strings present in Info.plist for all entitlements used
- Supports macOS 13 Ventura minimum (unless lower target declared in spec)
./gradlew assembleReleaseexits zero./gradlew test— all unit tests pass- Detekt static analysis — zero errors at
build.detekt.maxIssues = 0 - .aab signed with keystore — valid Play App Signing configuration
- R8 minification and obfuscation enabled in release build
- ProGuard rules present for all reflection-heavy dependencies
- Target API level ≥ 34 (Android 14) — Play Store requirement
- Minimum SDK ≥ 26 (Android 8.0) unless spec declares lower
- No cleartext network traffic (Network Security Config enforced)
xcodebuild -scheme [App] -configuration Releaseexits zero- All XCTest and Swift Testing targets pass
- App signed with Distribution certificate + provisioning profile
- Uploaded to TestFlight — passes App Store Connect automated review
- Privacy manifest (
PrivacyInfo.xcprivacy) present — required from iOS 17.4+ - All required usage description strings in Info.plist
- Deployment target ≥ iOS 16 unless spec declares lower
- No private API usage — scan with
nmbefore submission
Important Warnings
Platform constraints that will block your build or submission if not planned for in advance.
There is no workaround. Apple's signing tools run exclusively on macOS. Use a GitHub Actions macos-latest runner or a cloud Mac if you develop on Linux or Windows.
Physical device testing is free. Distribution to TestFlight or the App Store requires an Apple Developer Program membership at $99/year — no workaround exists for store distribution.
Without an Authenticode EV certificate, Windows Defender SmartScreen warns on first install. EV certs cost $300–500/year. Standard OV certs no longer suppress SmartScreen as of 2023.
New apps and updates must target at least Android 14 (API 34). This floor increases annually — verify the current Play Store policy before starting your project.
There is no single Linux packaging standard. You may need .deb, .rpm, and/or AppImage/Flatpak. Flatpak is the closest universal format but requires portal permission handling for system access.
Apple's notarization service is asynchronous. Budget time for it in your CI release pipeline — do not run it manually at release time.
When Apple or Google ships a new OS API, Flutter, React Native, and Tauri plugins typically lag by 3–12 months. Plan for native implementation if your spec depends on a brand-new platform feature.
Even with Tauri (Rust-based), macOS builds require Xcode Command Line Tools for compilation and Apple codesign for signing. This is a macOS OS requirement, not Tauri's.
Real-World Scenarios
How the pipeline handles common multi-platform project requests.