Build & Deploy From Your Pocket.
The GeeFox documentation hub for building, managing, automating and deploying software from a mobile-first developer environment.
Installation
GeeFox is designed as a Progressive Web App (PWA), allowing developers to access a mobile-first development environment directly from a modern browser without requiring a traditional app-store installation.
iPhone & iPad
Install GeeFox from Safari using the native Add to Home Screen workflow.
Android
Use Chrome's install or Add to Home Screen option for a dedicated experience.
1. Open Safari on your iPhone or iPad
2. Navigate to app.geefox.xyz
3. Tap the Share button
4. Select "Add to Home Screen"
5. Confirm the installation
1. Open Chrome on your Android device
2. Navigate to app.geefox.xyz
3. Open the browser menu
4. Select "Install app" or "Add to Home screen"
5. Confirm the installation
Quick Start
Start with the core GeeFox workflow and move from account setup to project deployment in a few focused steps.
Create Your Account
Sign up using a supported authentication method and access your GeeFox workspace.
Connect Your Repository
Import an existing project or connect a repository to begin managing your source code.
Start Building
Commit changes, manage branches, trigger workflows and prepare deployments from your mobile device.
Git Management
Manage source code workflows through touch-optimized interfaces designed around common Git operations.
Creating a Repository
- Tap + New.
- Select Create Repository.
- Enter the repository name and description.
- Choose the desired visibility.
- Confirm repository creation.
Branch Operations
# Create a new branch
git checkout -b feature/new-feature
# Stage and commit changes
git add .
git commit -m "Add new feature"
# Push the branch
git push origin feature/new-feature
Deployments
Connect your development workflow to deployment providers and move projects from source control toward production with a mobile-friendly workflow.
Deployment principle
Keep production deployments reproducible: source control, build configuration, environment variables and deployment targets should be explicitly defined and independently verifiable.
Cloud Storage
Organize project assets and development resources through a developer-focused storage workflow.
File Upload
Upload project assets through a mobile-first interface designed for touch interaction.
Version Control
Maintain controlled asset revisions and establish clear rollback paths where supported by your storage workflow.
Team Collaboration
Build software together while away from a traditional workstation. GeeFox brings repository and project collaboration into a mobile-first workflow.
Code Reviews
Review changes, discuss implementation details and participate in repository workflows from a touch interface.
Role-Based Access
Manage contributors, permissions and repository access using defined collaboration roles.
Mobile Workflow
GeeFox is designed around touch interaction, responsive layouts and the realities of developing from smaller screens.
Touch-Optimized Controls
Primary interactions use large targets and responsive layouts suitable for mobile devices.
Mobile-First Navigation
Important documentation and development actions remain accessible without requiring desktop navigation patterns.
Responsive Development
Use the same project workflow across mobile and larger screens while preserving the appropriate information density.
CI/CD Setup
Define repeatable build and deployment workflows with configuration that can be reviewed and version-controlled alongside your project.
name: Mobile Build Pipeline
on: [push, pull_request]
jobs:
build:
runs-on: geefox-mobile-runner
steps:
- uses: actions/checkout@v3
- run: npm install && npm run build
Security
Secure development workflows require strong authentication, carefully scoped credentials and controlled access to project environments.
Authentication
Use strong authentication and protect account credentials, API keys and session access.
Controlled Environments
Keep preview environments, credentials and deployment permissions isolated according to project requirements.
REST API
Programmatically interact with GeeFox resources through HTTP-based API requests using authenticated credentials.
curl -X POST https://api.geefox.xyz/v1/repositories \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "my-mobile-app",
"visibility": "private"
}'
import { GeeFox } from '@geefox/sdk';
const client = new GeeFox({
apiKey: 'YOUR_API_KEY'
});
const repo = await client.repositories.create({
name: 'my-mobile-app',
visibility: 'private'
});
from geefox import GeeFox
client = GeeFox(api_key="YOUR_API_KEY")
repo = client.repositories.create(
name="my-mobile-app",
visibility="private"
)
Authentication Required
Protect API credentials and send authentication information using the mechanism required by your GeeFox API configuration.
Webhooks
Webhooks allow your systems to receive HTTP callbacks when supported events occur in a GeeFox workflow.
deployment.created
Triggered when a deployment begins.
deployment.succeeded
Triggered after a deployment completes successfully.
deployment.failed
Triggered when a deployment fails.
{
"id": "evt_123456789",
"type": "deployment.succeeded",
"created_at": "2023-10-25T10:00:00Z",
"data": {
"deployment_id": "dep_987654321",
"url": "https://my-app.geefox.app"
}
}
SDKs
Use language-specific libraries where available to integrate GeeFox capabilities into your development workflow.
Troubleshooting
Review common integration and deployment problems before escalating an issue.
401 Unauthorized API Errors
Verify that your API credential is valid, correctly formatted and permitted to access the requested resource. Check whether the credential has expired, been revoked or lacks the required scope.
Deployment Stuck in "Building"
Inspect the deployment logs first. Look for dependency installation failures, hanging processes, invalid build commands, missing environment variables or resource limits.
Webhook Signature Verification Failing
Verify signatures against the original request payload before JSON parsing or transformation. Ensure the signing secret and verification algorithm match the webhook configuration.