GitStable Documentation - Complete Platform Guide

🌟 Platform Overview

GitStable is the first commerce platform built specifically for Git repositories. It enables developers to monetize their code through instant stablecoin payments while maintaining their existing Git workflow.

⚡

Instant Payments

Stablecoin payments arrive in 1-3 seconds globally

🔗

Git Native

Built on Git's distributed architecture

🌍

Global Reach

Accept payments from anywhere without banking restrictions

💎

Keep 95%+

Low $25/month subscription, no transaction fees

Core Concepts

Repository Monetization: Turn any Git repository into a revenue stream
Commit-Based Billing: Each commit can represent billable work
Automated Licensing: Code rights transfer automatically upon payment
Version Control Commerce: Sell different access levels to different commits/branches

⚙️ Account Setup

1. Create Your GitStable Account

# Sign up at gitstable.com
curl -X POST https://api.gitstable.com/auth/signup \
  -H "Content-Type: application/json" \
  -d '{
    "username": "yourusername",
    "email": "your@email.com",
    "password": "secure_password"
  }'
                    

2. Configure Your Developer Profile

# Set your profile information
git config --global gitstable.username yourusername
git config --global gitstable.email your@email.com
git config --global gitstable.wallet 0x1234...abcd

# Set default pricing (can be overridden per repo)
git config --global gitstable.pricing.bugfix 25
git config --global gitstable.pricing.feature 150
git config --global gitstable.pricing.consulting 85
                    

💡 Pro Tip

Use different pricing strategies for different types of repositories. Tutorial repos might have lower prices but higher volume, while specialized consulting repos can command premium rates.

📁 Your First GitStable Repository

Adding GitStable to Existing Repository

# Navigate to your project
cd my-awesome-project

# Add GitStable as remote (keeps existing setup)
git remote add gitstable https://gitstable.com/yourusername/my-awesome-project

# Configure pricing for this specific repo
git config gitstable.pricing.enabled true
git config gitstable.pricing.tiers "free,developer,commercial"

# Set tier pricing
git config gitstable.pricing.developer 25
git config gitstable.pricing.commercial 199

# Push to GitStable (creates monetized repository)
git push gitstable main
                    

Repository Structure for Monetization

my-awesome-project/
├── README.md                 # Free tier - always accessible
├── LICENSE                   # Free tier - licensing info
├── examples/                 # Free tier - basic examples
│   └── simple_example.py
├── src/                      # Developer tier - core source
│   ├── main.py
│   └── advanced_features.py
├── premium/                  # Commercial tier - advanced features
│   ├── enterprise_config.py
│   └── custom_integrations/
└── .gitstable.yml           # GitStable configuration
                    

GitStable Configuration File

# .gitstable.yml
version: "1.0"
pricing:
  tiers:
    free:
      price: 0
      includes:
        - "README.md"
        - "LICENSE"
        - "examples/**"
    developer:
      price: 25
      currency: "USDC"
      includes:
        - "src/**"
        - "docs/**"
        - "tests/**"
    commercial:
      price: 199
      currency: "USDC"
      includes:
        - "**"
      license: "commercial"
                    

💳 Payment Setup

Supported Stablecoins

Stablecoin	Networks	Typical Fees	Settlement Time
USDC	Ethereum, Polygon, Base, Arbitrum	$0.01 - $0.50	1-3 seconds
USDT	Ethereum, Tron, BSC	$0.01 - $1.00	1-5 seconds
DAI	Ethereum, Polygon	$0.01 - $0.50	1-3 seconds
FRAX	Ethereum, Fraxtal	$0.01 - $0.30	1-2 seconds

Wallet Configuration

# Configure your payment wallet
git config gitstable.wallet.address 0x1234567890abcdef...
git config gitstable.wallet.network base
git config gitstable.wallet.preferred USDC

# Set automatic payment thresholds
git config gitstable.payments.minimum 5
git config gitstable.payments.auto_withdraw 100
                    

⚠️ Security Note

Never commit private keys to your repository. GitStable uses secure wallet connections and never requires private key access. Use hardware wallets for maximum security.

🔧 Git Integration Commands

Basic GitStable Commands

# Initialize GitStable in existing repo
git gitstable init

# Check GitStable status
git gitstable status

# View current pricing configuration
git gitstable pricing

# Generate invoice for recent commits
git gitstable invoice --since="last week"

# Check payment status
git gitstable payments
                    

Commit-Based Billing

# Commit with billing tags
git commit -m "Fix user authentication bug [billing:bugfix]"
git commit -m "Add payment gateway integration [billing:feature]"
git commit -m "Performance optimization [billing:consulting]"

# Custom pricing for specific commits
git commit -m "Critical security fix [billing:security:$500]"

# Push to generate billable items
git push gitstable main
                    

Branch-Based Access Control

# Create different access levels
git checkout -b free-tier
git checkout -b premium-features
git checkout -b enterprise-only

# Configure branch pricing
git config branch.free-tier.gitstable.price 0
git config branch.premium-features.gitstable.price 50
git config branch.enterprise-only.gitstable.price 500
                    

🛠️ API Reference

📋 Base URL

https://api.gitstable.com/v1

All API requests require authentication via API key or OAuth token.

Authentication

POST /auth/token

Generate API access token

curl -X POST https://api.gitstable.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "username": "yourusername",
    "password": "yourpassword"
  }'
                        

Repository Management

GET /repositories

List all your monetized repositories

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Results per page (default: 20, max: 100)

POST /repositories

Create new monetized repository

curl -X POST https://api.gitstable.com/v1/repositories \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-awesome-project",
    "description": "Revolutionary development tool",
    "pricing": {
      "developer": { "price": 25, "currency": "USDC" },
      "commercial": { "price": 199, "currency": "USDC" }
    }
  }'
                        

Payments API

GET /payments

Retrieve payment history

Parameter	Type	Description
from_date	string	ISO 8601 date (e.g., 2025-01-01)
to_date	string	ISO 8601 date
status	string	pending, completed, failed

POST /payments/invoice

Generate invoice for repository access

curl -X POST https://api.gitstable.com/v1/payments/invoice \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repository_id": "repo_123",
    "tier": "developer",
    "client_email": "client@example.com"
  }'
                        

🤖 AI Creator Tools

GitStable isn't just for traditional code - it's perfect for AI-generated content, prompts, and workflows.

AI Content Types

💬

Prompt Collections

ChatGPT, Claude, and Gemini prompts with version control

🎨

AI Art Workflows

Midjourney, DALL-E, and Stable Diffusion processes

🎵

Audio Generation

Music prompts, voice synthesis, and audio workflows

📝

Content Templates

Blog posts, marketing copy, and document templates

AI Prompt Repository Structure

ai-prompts-collection/
├── README.md                    # Free - overview and samples
├── basic-prompts/              # Free tier
│   ├── writing-assistant.md
│   └── code-helper.md
├── advanced-prompts/           # $15 tier
│   ├── marketing-copy.md
│   ├── technical-writing.md
│   └── creative-fiction.md
├── premium-workflows/          # $50 tier
│   ├── complete-blog-system.md
│   ├── product-launch-sequence.md
│   └── ai-art-generation.md
└── .gitstable.yml
                    

Versioning AI Content

# Track prompt evolution
git add prompts/marketing-copy-v1.md
git commit -m "Initial marketing copy prompts [ai:prompts]"

# Improve and version
git add prompts/marketing-copy-v2.md
git commit -m "Improved conversion rates by 40% [ai:prompts:$25]"

# Complete workflow
git add workflows/complete-campaign.md
git commit -m "Full campaign workflow with A/B testing [ai:workflow:$100]"
                    

💡 AI Creator Success Story

A prompt engineer selling optimized ChatGPT workflows earned $2,400 in their first month by pricing prompt collections at $15-50 each. Version control helped buyers see the development process and trust the quality.

💼 Client Billing Use Cases

Transparent Project Billing

# Start client project with clear billing
git init client-ecommerce-project
git remote add gitstable https://gitstable.com/dev/client-project

# Each feature gets its own commit with pricing
git commit -m "Add user authentication system [billing:feature:$150]"
git commit -m "Fix payment gateway bug [billing:bugfix:$75]"
git commit -m "Optimize database queries [billing:optimization:$100]"

# Generate client invoice
git gitstable invoice --client="TechStartup Inc" --period="week"
                    

Example Client Invoice Output

GitStable Invoice #GST-2025-0142
Client: TechStartup Inc.
Period: January 15-22, 2025

Commits:
  a7f3c2d - Add user authentication system         $150 USDC
  b84e1f9 - Fix payment gateway integration bug    $75 USDC  
  c92d5a8 - Add shopping cart persistence          $125 USDC
  d6f8b3e - Optimize database queries              $100 USDC
  e1a9c4f - Mobile responsive checkout design      $200 USDC

Total: $650 USDC
Payment due immediately upon approval.
Full code ownership rights transfer upon payment.
                    

🔍 Why This Works

Clients love GitStable billing because they can see exactly what work was done, when it was completed, and verify it's working before paying. No more "what did I pay for?" disputes.

📚 GitStable Documentation