Firebase App Hosting Configuration
Relevant source files
The following files were used as context for generating this wiki page:
Firebase App Hosting Configuration defines the integration parameters and deployment environment for the KernelForge application. KernelForge originates from Firebase Studio and utilizes a tech stack comprising Next.js and Capacitor to deliver a mobile-native dashboard for Android kernel development.
The project structure supports both static web deployment and native Android packaging. Configuration elements include metadata for Progressive Web App (PWA) capabilities and dependencies required for Firebase platform services.
Sources: metadata.json:1-4, README.md:1-12, package.json:1-10
Project Environment and Metadata
The application identifies as "studio-73359690" within the Firebase ecosystem, reflecting its origin as an imported project from Firebase Studio. The core project metadata defines its identity and purpose as a specialized development tool.
Sources: metadata.json:1-4, src/app/layout.tsx:4-16
Core Dependencies
The project utilizes the firebase package to interact with Firebase services. It also employs @genkit-ai/google-genai for AI-powered features like the log troubleshooting assistant.
| Dependency | Version | Purpose |
|---|---|---|
firebase | ^11.9.1 | Platform integration and hosting services |
next | 16.3.8 | Web framework for the dashboard UI |
@genkit-ai/google-genai | ^1.28.0 | AI-powered troubleshooting flows |
lucide-react | 0.475.0 | Iconography for the dashboard interface |
Sources: package.json:44, package.json:48, package.json:33, package.json:57
Deployment Architecture
KernelForge employs a dual-targeted deployment strategy. It functions as a hosted web application while simultaneously providing a path for native Android APK generation via a Capacitor wrapper.
The diagram shows the build flow from source code to target deployment environments.
Sources: README.md:14-25, package.json:7-14
Build Scripts
The package.json file defines specific scripts for different hosting and export scenarios:
build: Generates a production-ready Next.js build.build:static: Produces a static export suitable for Firebase App Hosting or Capacitor injection.genkit:dev: Starts the Genkit development environment for AI feature testing.
Sources: package.json:7-14
Web and Native Configuration
The application includes specific configurations for web environments to ensure proper rendering and behavior when hosted.
PWA and Viewport Settings
The src/app/layout.tsx file configures metadata essential for web hosting and PWA functionality, including theme colors and status bar styles for mobile browsers.
| Configuration Field | Value | Description |
|---|---|---|
themeColor | #00ff55 | Primary brand color for the browser UI |
appleWebApp.capable | true | Enables standalone mode on iOS devices |
viewport.userScalable | false | Prevents zooming to maintain app-like feel |
manifest | /manifest.json | Path to the web app manifest |
Sources: src/app/layout.tsx:18-25, src/app/layout.tsx:4-16
Native Bridge Integration
For mobile deployment, the app uses Capacitor 6. This configuration allows the statically exported Next.js payload to interact with the Android OS.
This diagram illustrates the interaction between the hosted web layer and the native device capabilities.
Sources: README.md:19-21, package.json:30-32
Troubleshooting and AI Integration
The hosting environment supports AI-powered analysis through the AITroubleshooter component. This module processes kernel build logs to identify errors.
- Mock Assistant: Due to the static export nature of the Android APK, the system includes a mock assistant (
ai-build-troubleshooting-assistant.ts) to simulate analysis when a backend server is unreachable. - Input Schema: The assistant expects
buildLog(string) and optionaldeviceInfo(object). - Output Schema: The system returns a
summary,identifiedErrors(array), andsuggestedSolutions(array).
Sources: src/components/dashboard/AITroubleshooter.tsx:1-15, src/ai/flows/ai-build-troubleshooting-assistant.ts:1-35
Conclusion
The Firebase App Hosting Configuration for KernelForge enables a versatile deployment model. By combining Next.js static builds with Capacitor and Firebase services, the project maintains a professional web presence while providing a high-performance native toolkit for Android kernel developers. Configuration is primarily managed through package.json, metadata.json, and Next.js layout metadata.
Sources: README.md:1-5, metadata.json:1-4