GeeFox v1.0.0

Build & Deploy From Your Pocket.

The GeeFox documentation hub for building, managing, automating and deploying software from a mobile-first developer environment.

geefox-cli / production
$
Building project...
Optimizing assets...
Deployed to app.geefox.xyz
$
01 / Getting Started

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.

iOS / Safari
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
Android / Chrome
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
02 / Getting Started

Quick Start

Start with the core GeeFox workflow and move from account setup to project deployment in a few focused steps.

01

Create Your Account

Sign up using a supported authentication method and access your GeeFox workspace.

02

Connect Your Repository

Import an existing project or connect a repository to begin managing your source code.

03

Start Building

Commit changes, manage branches, trigger workflows and prepare deployments from your mobile device.

03 / Core Features

Git Management

Manage source code workflows through touch-optimized interfaces designed around common Git operations.

Creating a Repository

  1. Tap + New.
  2. Select Create Repository.
  3. Enter the repository name and description.
  4. Choose the desired visibility.
  5. Confirm repository creation.

Branch Operations

Git
# 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
04 / Core Features

Deployments

Connect your development workflow to deployment providers and move projects from source control toward production with a mobile-friendly workflow.

Vercel
Netlify
Cloudflare Pages
GitLab Pages

Deployment principle

Keep production deployments reproducible: source control, build configuration, environment variables and deployment targets should be explicitly defined and independently verifiable.

05 / Core Features

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.

06 / Core Features

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.

07 / Guides

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.

08 / Guides

CI/CD Setup

Define repeatable build and deployment workflows with configuration that can be reviewed and version-controlled alongside your project.

.geefox/ci.yml
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
09 / Guides

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.

10 / API Reference

REST API

Programmatically interact with GeeFox resources through HTTP-based API requests using authenticated credentials.

POST /v1/repositories
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"
  }'
Node.js
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'
});
Python
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.

11 / API Reference

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.

Webhook payload
{
  "id": "evt_123456789",
  "type": "deployment.succeeded",
  "created_at": "2023-10-25T10:00:00Z",
  "data": {
    "deployment_id": "dep_987654321",
    "url": "https://my-app.geefox.app"
  }
}
12 / API Reference

SDKs

Use language-specific libraries where available to integrate GeeFox capabilities into your development workflow.

JavaScript / Node
npm install @geefox/sdk
Python
pip install geefox-python
Go
go get github.com/geefox/go-sdk
13 / Support

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.