home / skills / plurigrid / asi / flow-nexus-platform

flow-nexus-platform skill

/skills/flow-nexus-platform

This skill helps you manage the Flow Nexus platform end-to-end, including authentication, sandboxes, deploys, payments, and challenges with streamlined

npx playbooks add skill plurigrid/asi --skill flow-nexus-platform

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
25.0 KB
---
name: flow-nexus-platform
description: Comprehensive Flow Nexus platform management - authentication, sandboxes, app deployment, payments, and challenges
category: platform
version: 1.0.0
author: Flow Nexus
tags: [authentication, sandboxes, deployment, payments, gamification, cloud]
---

# Flow Nexus Platform Management

Comprehensive platform management for Flow Nexus - covering authentication, sandbox execution, app deployment, credit management, and coding challenges.

## Table of Contents
1. [Authentication & User Management](#authentication--user-management)
2. [Sandbox Management](#sandbox-management)
3. [App Store & Deployment](#app-store--deployment)
4. [Payments & Credits](#payments--credits)
5. [Challenges & Achievements](#challenges--achievements)
6. [Storage & Real-time](#storage--real-time)
7. [System Utilities](#system-utilities)

---

## Authentication & User Management

### Registration & Login

**Register New Account**
```javascript
mcp__flow-nexus__user_register({
  email: "[email protected]",
  password: "secure_password",
  full_name: "Your Name",
  username: "unique_username" // optional
})
```

**Login**
```javascript
mcp__flow-nexus__user_login({
  email: "[email protected]",
  password: "your_password"
})
```

**Check Authentication Status**
```javascript
mcp__flow-nexus__auth_status({ detailed: true })
```

**Logout**
```javascript
mcp__flow-nexus__user_logout()
```

### Password Management

**Request Password Reset**
```javascript
mcp__flow-nexus__user_reset_password({
  email: "[email protected]"
})
```

**Update Password with Token**
```javascript
mcp__flow-nexus__user_update_password({
  token: "reset_token_from_email",
  new_password: "new_secure_password"
})
```

**Verify Email**
```javascript
mcp__flow-nexus__user_verify_email({
  token: "verification_token_from_email"
})
```

### Profile Management

**Get User Profile**
```javascript
mcp__flow-nexus__user_profile({
  user_id: "your_user_id"
})
```

**Update Profile**
```javascript
mcp__flow-nexus__user_update_profile({
  user_id: "your_user_id",
  updates: {
    full_name: "Updated Name",
    bio: "AI Developer and researcher",
    github_username: "yourusername",
    twitter_handle: "@yourhandle"
  }
})
```

**Get User Statistics**
```javascript
mcp__flow-nexus__user_stats({
  user_id: "your_user_id"
})
```

**Upgrade User Tier**
```javascript
mcp__flow-nexus__user_upgrade({
  user_id: "your_user_id",
  tier: "pro" // pro, enterprise
})
```

---

## Sandbox Management

### Create & Configure Sandboxes

**Create Sandbox**
```javascript
mcp__flow-nexus__sandbox_create({
  template: "node", // node, python, react, nextjs, vanilla, base, claude-code
  name: "my-sandbox",
  env_vars: {
    API_KEY: "your_api_key",
    NODE_ENV: "development",
    DATABASE_URL: "postgres://..."
  },
  install_packages: ["express", "cors", "dotenv"],
  startup_script: "npm run dev",
  timeout: 3600, // seconds
  metadata: {
    project: "my-project",
    environment: "staging"
  }
})
```

**Configure Existing Sandbox**
```javascript
mcp__flow-nexus__sandbox_configure({
  sandbox_id: "sandbox_id",
  env_vars: {
    NEW_VAR: "value"
  },
  install_packages: ["axios", "lodash"],
  run_commands: ["npm run migrate", "npm run seed"],
  anthropic_key: "sk-ant-..." // For Claude Code integration
})
```

### Execute Code

**Run Code in Sandbox**
```javascript
mcp__flow-nexus__sandbox_execute({
  sandbox_id: "sandbox_id",
  code: `
    console.log('Hello from sandbox!');
    const result = await fetch('https://api.example.com/data');
    const data = await result.json();
    return data;
  `,
  language: "javascript",
  capture_output: true,
  timeout: 60, // seconds
  working_dir: "/app",
  env_vars: {
    TEMP_VAR: "override"
  }
})
```

### Manage Sandboxes

**List Sandboxes**
```javascript
mcp__flow-nexus__sandbox_list({
  status: "running" // running, stopped, all
})
```

**Get Sandbox Status**
```javascript
mcp__flow-nexus__sandbox_status({
  sandbox_id: "sandbox_id"
})
```

**Upload File to Sandbox**
```javascript
mcp__flow-nexus__sandbox_upload({
  sandbox_id: "sandbox_id",
  file_path: "/app/config/database.json",
  content: JSON.stringify(databaseConfig, null, 2)
})
```

**Get Sandbox Logs**
```javascript
mcp__flow-nexus__sandbox_logs({
  sandbox_id: "sandbox_id",
  lines: 100 // max 1000
})
```

**Stop Sandbox**
```javascript
mcp__flow-nexus__sandbox_stop({
  sandbox_id: "sandbox_id"
})
```

**Delete Sandbox**
```javascript
mcp__flow-nexus__sandbox_delete({
  sandbox_id: "sandbox_id"
})
```

### Sandbox Templates

- **node**: Node.js environment with npm
- **python**: Python 3.x with pip
- **react**: React development setup
- **nextjs**: Next.js full-stack framework
- **vanilla**: Basic HTML/CSS/JS
- **base**: Minimal Linux environment
- **claude-code**: Claude Code integrated environment

### Common Sandbox Patterns

**API Development Sandbox**
```javascript
mcp__flow-nexus__sandbox_create({
  template: "node",
  name: "api-development",
  install_packages: [
    "express",
    "cors",
    "helmet",
    "dotenv",
    "jsonwebtoken",
    "bcrypt"
  ],
  env_vars: {
    PORT: "3000",
    NODE_ENV: "development"
  },
  startup_script: "npm run dev"
})
```

**Machine Learning Sandbox**
```javascript
mcp__flow-nexus__sandbox_create({
  template: "python",
  name: "ml-training",
  install_packages: [
    "numpy",
    "pandas",
    "scikit-learn",
    "matplotlib",
    "tensorflow"
  ],
  env_vars: {
    CUDA_VISIBLE_DEVICES: "0"
  }
})
```

**Full-Stack Development**
```javascript
mcp__flow-nexus__sandbox_create({
  template: "nextjs",
  name: "fullstack-app",
  install_packages: [
    "prisma",
    "@prisma/client",
    "next-auth",
    "zod"
  ],
  env_vars: {
    DATABASE_URL: "postgresql://...",
    NEXTAUTH_SECRET: "secret"
  }
})
```

---

## App Store & Deployment

### Browse & Search

**Search Applications**
```javascript
mcp__flow-nexus__app_search({
  search: "authentication api",
  category: "backend",
  featured: true,
  limit: 20
})
```

**Get App Details**
```javascript
mcp__flow-nexus__app_get({
  app_id: "app_id"
})
```

**List Templates**
```javascript
mcp__flow-nexus__app_store_list_templates({
  category: "web-api",
  tags: ["express", "jwt", "typescript"],
  limit: 20
})
```

**Get Template Details**
```javascript
mcp__flow-nexus__template_get({
  template_name: "express-api-starter",
  template_id: "template_id" // alternative
})
```

**List All Available Templates**
```javascript
mcp__flow-nexus__template_list({
  category: "backend",
  template_type: "starter",
  featured: true,
  limit: 50
})
```

### Publish Applications

**Publish App to Store**
```javascript
mcp__flow-nexus__app_store_publish_app({
  name: "JWT Authentication Service",
  description: "Production-ready JWT authentication microservice with refresh tokens",
  category: "backend",
  version: "1.0.0",
  source_code: sourceCodeString,
  tags: ["auth", "jwt", "express", "typescript", "security"],
  metadata: {
    author: "Your Name",
    license: "MIT",
    repository: "github.com/username/repo",
    homepage: "https://yourapp.com",
    documentation: "https://docs.yourapp.com"
  }
})
```

**Update Application**
```javascript
mcp__flow-nexus__app_update({
  app_id: "app_id",
  updates: {
    version: "1.1.0",
    description: "Added OAuth2 support",
    tags: ["auth", "jwt", "oauth2", "express"],
    source_code: updatedSourceCode
  }
})
```

### Deploy Templates

**Deploy Template**
```javascript
mcp__flow-nexus__template_deploy({
  template_name: "express-api-starter",
  deployment_name: "my-production-api",
  variables: {
    api_key: "your_api_key",
    database_url: "postgres://user:pass@host:5432/db",
    redis_url: "redis://localhost:6379"
  },
  env_vars: {
    NODE_ENV: "production",
    PORT: "8080",
    LOG_LEVEL: "info"
  }
})
```

### Analytics & Management

**Get App Analytics**
```javascript
mcp__flow-nexus__app_analytics({
  app_id: "your_app_id",
  timeframe: "30d" // 24h, 7d, 30d, 90d
})
```

**View Installed Apps**
```javascript
mcp__flow-nexus__app_installed({
  user_id: "your_user_id"
})
```

**Get Market Statistics**
```javascript
mcp__flow-nexus__market_data()
```

### App Categories

- **web-api**: RESTful APIs and microservices
- **frontend**: React, Vue, Angular applications
- **full-stack**: Complete end-to-end applications
- **cli-tools**: Command-line utilities
- **data-processing**: ETL pipelines and analytics
- **ml-models**: Pre-trained machine learning models
- **blockchain**: Web3 and blockchain applications
- **mobile**: React Native and mobile apps

### Publishing Best Practices

1. **Documentation**: Include comprehensive README with setup instructions
2. **Examples**: Provide usage examples and sample configurations
3. **Testing**: Include test suite and CI/CD configuration
4. **Versioning**: Use semantic versioning (MAJOR.MINOR.PATCH)
5. **Licensing**: Add clear license information (MIT, Apache, etc.)
6. **Deployment**: Include Docker/docker-compose configurations
7. **Migrations**: Provide upgrade guides for version updates
8. **Security**: Document security considerations and best practices

### Revenue Sharing

- Earn rUv credits when others deploy your templates
- Set pricing (0 for free, or credits for premium)
- Track usage and earnings via analytics
- Withdraw credits or use for Flow Nexus services

---

## Payments & Credits

### Balance & Credits

**Check Credit Balance**
```javascript
mcp__flow-nexus__check_balance()
```

**Check rUv Balance**
```javascript
mcp__flow-nexus__ruv_balance({
  user_id: "your_user_id"
})
```

**View Transaction History**
```javascript
mcp__flow-nexus__ruv_history({
  user_id: "your_user_id",
  limit: 100
})
```

**Get Payment History**
```javascript
mcp__flow-nexus__get_payment_history({
  limit: 50
})
```

### Purchase Credits

**Create Payment Link**
```javascript
mcp__flow-nexus__create_payment_link({
  amount: 50 // USD, minimum $10
})
// Returns secure Stripe payment URL
```

### Auto-Refill Configuration

**Enable Auto-Refill**
```javascript
mcp__flow-nexus__configure_auto_refill({
  enabled: true,
  threshold: 100,  // Refill when credits drop below 100
  amount: 50       // Purchase $50 worth of credits
})
```

**Disable Auto-Refill**
```javascript
mcp__flow-nexus__configure_auto_refill({
  enabled: false
})
```

### Credit Pricing

**Service Costs:**
- **Swarm Operations**: 1-10 credits/hour
- **Sandbox Execution**: 0.5-5 credits/hour
- **Neural Training**: 5-50 credits/job
- **Workflow Runs**: 0.1-1 credit/execution
- **Storage**: 0.01 credits/GB/day
- **API Calls**: 0.001-0.01 credits/request

### Earning Credits

**Ways to Earn:**
1. **Complete Challenges**: 10-500 credits per challenge
2. **Publish Templates**: Earn when others deploy (you set pricing)
3. **Referral Program**: Bonus credits for user invites
4. **Daily Login**: Small daily bonus (5-10 credits)
5. **Achievements**: Unlock milestone rewards (50-1000 credits)
6. **App Store Sales**: Revenue share from paid templates

**Earn Credits Programmatically**
```javascript
mcp__flow-nexus__app_store_earn_ruv({
  user_id: "your_user_id",
  amount: 100,
  reason: "Completed expert algorithm challenge",
  source: "challenge" // challenge, app_usage, referral, etc.
})
```

### Subscription Tiers

**Free Tier**
- 100 free credits monthly
- Basic sandbox access (2 concurrent)
- Limited swarm agents (3 max)
- Community support
- 1GB storage

**Pro Tier ($29/month)**
- 1000 credits monthly
- Priority sandbox access (10 concurrent)
- Unlimited swarm agents
- Advanced workflows
- Email support
- 10GB storage
- Early access to features

**Enterprise Tier (Custom Pricing)**
- Unlimited credits
- Dedicated compute resources
- Custom neural models
- 99.9% SLA guarantee
- Priority 24/7 support
- Unlimited storage
- White-label options
- On-premise deployment

### Cost Optimization Tips

1. **Use Smaller Sandboxes**: Choose appropriate templates (base vs full-stack)
2. **Optimize Neural Training**: Tune hyperparameters, reduce epochs
3. **Batch Operations**: Group workflow executions together
4. **Clean Up Resources**: Delete unused sandboxes and storage
5. **Monitor Usage**: Check `user_stats` regularly
6. **Use Free Templates**: Leverage community templates
7. **Schedule Off-Peak**: Run heavy jobs during low-cost periods

---

## Challenges & Achievements

### Browse Challenges

**List Available Challenges**
```javascript
mcp__flow-nexus__challenges_list({
  difficulty: "intermediate", // beginner, intermediate, advanced, expert
  category: "algorithms",
  status: "active", // active, completed, locked
  limit: 20
})
```

**Get Challenge Details**
```javascript
mcp__flow-nexus__challenge_get({
  challenge_id: "two-sum-problem"
})
```

### Submit Solutions

**Submit Challenge Solution**
```javascript
mcp__flow-nexus__challenge_submit({
  challenge_id: "challenge_id",
  user_id: "your_user_id",
  solution_code: `
    function twoSum(nums, target) {
      const map = new Map();
      for (let i = 0; i < nums.length; i++) {
        const complement = target - nums[i];
        if (map.has(complement)) {
          return [map.get(complement), i];
        }
        map.set(nums[i], i);
      }
      return [];
    }
  `,
  language: "javascript",
  execution_time: 45 // milliseconds (optional)
})
```

**Mark Challenge as Complete**
```javascript
mcp__flow-nexus__app_store_complete_challenge({
  challenge_id: "challenge_id",
  user_id: "your_user_id",
  submission_data: {
    passed_tests: 10,
    total_tests: 10,
    execution_time: 45,
    memory_usage: 2048 // KB
  }
})
```

### Leaderboards

**Global Leaderboard**
```javascript
mcp__flow-nexus__leaderboard_get({
  type: "global", // global, weekly, monthly, challenge
  limit: 100
})
```

**Challenge-Specific Leaderboard**
```javascript
mcp__flow-nexus__leaderboard_get({
  type: "challenge",
  challenge_id: "specific_challenge_id",
  limit: 50
})
```

### Achievements & Badges

**List User Achievements**
```javascript
mcp__flow-nexus__achievements_list({
  user_id: "your_user_id",
  category: "speed_demon" // Optional filter
})
```

### Challenge Categories

- **algorithms**: Classic algorithm problems (sorting, searching, graphs)
- **data-structures**: DS implementation (trees, heaps, tries)
- **system-design**: Architecture and scalability challenges
- **optimization**: Performance and efficiency problems
- **security**: Security-focused vulnerabilities and fixes
- **ml-basics**: Machine learning fundamentals
- **distributed-systems**: Concurrency and distributed computing
- **databases**: Query optimization and schema design

### Challenge Difficulty Rewards

- **Beginner**: 10-25 credits
- **Intermediate**: 50-100 credits
- **Advanced**: 150-300 credits
- **Expert**: 400-500 credits
- **Master**: 600-1000 credits

### Achievement Types

- **Speed Demon**: Complete challenges in record time
- **Code Golf**: Minimize code length
- **Perfect Score**: 100% test pass rate
- **Streak Master**: Complete challenges N days in a row
- **Polyglot**: Solve in multiple languages
- **Debugger**: Fix broken code challenges
- **Optimizer**: Achieve top performance benchmarks

### Tips for Success

1. **Start Simple**: Begin with beginner challenges to build confidence
2. **Review Solutions**: Study top solutions after completing
3. **Optimize**: Aim for both correctness and performance
4. **Daily Practice**: Complete daily challenges for bonus credits
5. **Community**: Engage with discussions and learn from others
6. **Track Progress**: Monitor achievements and leaderboard position
7. **Experiment**: Try multiple approaches to problems

---

## Storage & Real-time

### File Storage

**Upload File**
```javascript
mcp__flow-nexus__storage_upload({
  bucket: "my-bucket", // public, private, shared, temp
  path: "data/users.json",
  content: JSON.stringify(userData, null, 2),
  content_type: "application/json"
})
```

**List Files**
```javascript
mcp__flow-nexus__storage_list({
  bucket: "my-bucket",
  path: "data/", // prefix filter
  limit: 100
})
```

**Get Public URL**
```javascript
mcp__flow-nexus__storage_get_url({
  bucket: "my-bucket",
  path: "data/report.pdf",
  expires_in: 3600 // seconds (default: 1 hour)
})
```

**Delete File**
```javascript
mcp__flow-nexus__storage_delete({
  bucket: "my-bucket",
  path: "data/old-file.json"
})
```

### Storage Buckets

- **public**: Publicly accessible files (CDN-backed)
- **private**: User-only access with authentication
- **shared**: Team collaboration with ACL
- **temp**: Auto-deleted after 24 hours

### Real-time Subscriptions

**Subscribe to Database Changes**
```javascript
mcp__flow-nexus__realtime_subscribe({
  table: "tasks",
  event: "INSERT", // INSERT, UPDATE, DELETE, *
  filter: "status=eq.pending AND priority=eq.high"
})
```

**List Active Subscriptions**
```javascript
mcp__flow-nexus__realtime_list()
```

**Unsubscribe**
```javascript
mcp__flow-nexus__realtime_unsubscribe({
  subscription_id: "subscription_id"
})
```

### Execution Monitoring

**Subscribe to Execution Stream**
```javascript
mcp__flow-nexus__execution_stream_subscribe({
  stream_type: "claude-flow-swarm", // claude-code, claude-flow-swarm, claude-flow-hive-mind, github-integration
  deployment_id: "deployment_id",
  sandbox_id: "sandbox_id" // alternative
})
```

**Get Stream Status**
```javascript
mcp__flow-nexus__execution_stream_status({
  stream_id: "stream_id"
})
```

**List Generated Files**
```javascript
mcp__flow-nexus__execution_files_list({
  stream_id: "stream_id",
  created_by: "claude-flow", // claude-code, claude-flow, git-clone, user
  file_type: "javascript" // filter by extension
})
```

**Get File Content from Execution**
```javascript
mcp__flow-nexus__execution_file_get({
  file_id: "file_id",
  file_path: "/path/to/file.js" // alternative
})
```

---

## System Utilities

### Queen Seraphina AI Assistant

**Seek Guidance from Seraphina**
```javascript
mcp__flow-nexus__seraphina_chat({
  message: "How should I architect a distributed microservices system?",
  enable_tools: true, // Allow her to create swarms, deploy code, etc.
  conversation_history: [
    { role: "user", content: "I need help with system architecture" },
    { role: "assistant", content: "I can help you design that. What are your requirements?" }
  ]
})
```

Queen Seraphina is an advanced AI assistant with:
- Deep expertise in distributed systems
- Ability to create swarms and orchestrate agents
- Code deployment and architecture design
- Multi-turn conversation with context retention
- Tool usage for hands-on assistance

### System Health & Monitoring

**Check System Health**
```javascript
mcp__flow-nexus__system_health()
```

**View Audit Logs**
```javascript
mcp__flow-nexus__audit_log({
  user_id: "your_user_id", // optional filter
  limit: 100
})
```

### Authentication Management

**Initialize Authentication**
```javascript
mcp__flow-nexus__auth_init({
  mode: "user" // user, service
})
```

---

## Quick Start Guide

### Step 1: Register & Login

```javascript
// Register
mcp__flow-nexus__user_register({
  email: "[email protected]",
  password: "SecurePass123!",
  full_name: "Developer Name"
})

// Login
mcp__flow-nexus__user_login({
  email: "[email protected]",
  password: "SecurePass123!"
})

// Check auth status
mcp__flow-nexus__auth_status({ detailed: true })
```

### Step 2: Configure Billing

```javascript
// Check current balance
mcp__flow-nexus__check_balance()

// Add credits
const paymentLink = mcp__flow-nexus__create_payment_link({
  amount: 50 // $50
})

// Setup auto-refill
mcp__flow-nexus__configure_auto_refill({
  enabled: true,
  threshold: 100,
  amount: 50
})
```

### Step 3: Create Your First Sandbox

```javascript
// Create development sandbox
const sandbox = mcp__flow-nexus__sandbox_create({
  template: "node",
  name: "dev-environment",
  install_packages: ["express", "dotenv"],
  env_vars: {
    NODE_ENV: "development"
  }
})

// Execute code
mcp__flow-nexus__sandbox_execute({
  sandbox_id: sandbox.id,
  code: 'console.log("Hello Flow Nexus!")',
  language: "javascript"
})
```

### Step 4: Deploy an App

```javascript
// Browse templates
mcp__flow-nexus__template_list({
  category: "backend",
  featured: true
})

// Deploy template
mcp__flow-nexus__template_deploy({
  template_name: "express-api-starter",
  deployment_name: "my-api",
  variables: {
    database_url: "postgres://..."
  }
})
```

### Step 5: Complete a Challenge

```javascript
// Find challenges
mcp__flow-nexus__challenges_list({
  difficulty: "beginner",
  category: "algorithms"
})

// Submit solution
mcp__flow-nexus__challenge_submit({
  challenge_id: "fizzbuzz",
  user_id: "your_id",
  solution_code: "...",
  language: "javascript"
})
```

---

## Best Practices

### Security
1. Never hardcode API keys - use environment variables
2. Enable 2FA when available
3. Regularly rotate passwords and tokens
4. Use private buckets for sensitive data
5. Review audit logs periodically
6. Set appropriate file expiration times

### Performance
1. Clean up unused sandboxes to save credits
2. Use smaller sandbox templates when possible
3. Optimize storage by deleting old files
4. Batch operations to reduce API calls
5. Monitor usage via `user_stats`
6. Use temp buckets for transient data

### Development
1. Start with sandbox testing before deployment
2. Version your applications semantically
3. Document all templates thoroughly
4. Include tests in published apps
5. Use execution monitoring for debugging
6. Leverage real-time subscriptions for live updates

### Cost Management
1. Set auto-refill thresholds carefully
2. Monitor credit usage regularly
3. Complete daily challenges for bonus credits
4. Publish templates to earn passive credits
5. Use free-tier resources when appropriate
6. Schedule heavy jobs during off-peak times

---

## Troubleshooting

### Authentication Issues
- **Login Failed**: Check email/password, verify email first
- **Token Expired**: Re-login to get fresh tokens
- **Permission Denied**: Check tier limits, upgrade if needed

### Sandbox Issues
- **Sandbox Won't Start**: Check template compatibility, verify credits
- **Execution Timeout**: Increase timeout parameter or optimize code
- **Out of Memory**: Use larger template or optimize memory usage
- **Package Install Failed**: Check package name, verify npm/pip availability

### Payment Issues
- **Payment Failed**: Check payment method, sufficient funds
- **Credits Not Applied**: Allow 5-10 minutes for processing
- **Auto-refill Not Working**: Verify payment method on file

### Challenge Issues
- **Submission Rejected**: Check code syntax, ensure all tests pass
- **Wrong Answer**: Review test cases, check edge cases
- **Performance Too Slow**: Optimize algorithm complexity

---

## Support & Resources

- **Documentation**: https://docs.flow-nexus.ruv.io
- **API Reference**: https://api.flow-nexus.ruv.io/docs
- **Status Page**: https://status.flow-nexus.ruv.io
- **Community Forum**: https://community.flow-nexus.ruv.io
- **GitHub Issues**: https://github.com/ruvnet/flow-nexus/issues
- **Discord**: https://discord.gg/flow-nexus
- **Email Support**: [email protected] (Pro/Enterprise only)

---

## Progressive Disclosure

<details>
<summary><strong>Advanced Sandbox Configuration</strong></summary>

### Custom Docker Images
```javascript
mcp__flow-nexus__sandbox_create({
  template: "base",
  name: "custom-environment",
  startup_script: `
    apt-get update
    apt-get install -y custom-package
    git clone https://github.com/user/repo
    cd repo && npm install
  `
})
```

### Multi-Stage Execution
```javascript
// Stage 1: Setup
mcp__flow-nexus__sandbox_execute({
  sandbox_id: "id",
  code: "npm install && npm run build"
})

// Stage 2: Run
mcp__flow-nexus__sandbox_execute({
  sandbox_id: "id",
  code: "npm start",
  working_dir: "/app/dist"
})
```

</details>

<details>
<summary><strong>Advanced Storage Patterns</strong></summary>

### Large File Upload (Chunked)
```javascript
const chunkSize = 5 * 1024 * 1024 // 5MB chunks
for (let i = 0; i < chunks.length; i++) {
  await mcp__flow-nexus__storage_upload({
    bucket: "private",
    path: `large-file.bin.part${i}`,
    content: chunks[i]
  })
}
```

### Storage Lifecycle
```javascript
// Upload to temp for processing
mcp__flow-nexus__storage_upload({
  bucket: "temp",
  path: "processing/data.json",
  content: data
})

// Move to permanent storage after processing
mcp__flow-nexus__storage_upload({
  bucket: "private",
  path: "archive/processed-data.json",
  content: processedData
})
```

</details>

<details>
<summary><strong>Advanced Real-time Patterns</strong></summary>

### Multi-Table Sync
```javascript
const tables = ["users", "tasks", "notifications"]
tables.forEach(table => {
  mcp__flow-nexus__realtime_subscribe({
    table,
    event: "*",
    filter: `user_id=eq.${userId}`
  })
})
```

### Event-Driven Workflows
```javascript
// Subscribe to task completion
mcp__flow-nexus__realtime_subscribe({
  table: "tasks",
  event: "UPDATE",
  filter: "status=eq.completed"
})

// Trigger notification workflow on event
// (handled by your application logic)
```

</details>

---

## Version History

- **v1.0.0** (2025-10-19): Initial comprehensive platform skill
  - Authentication & user management
  - Sandbox creation and execution
  - App store and deployment
  - Payments and credits
  - Challenges and achievements
  - Storage and real-time features
  - System utilities and Queen Seraphina integration

---

*This skill consolidates 6 Flow Nexus command modules into a single comprehensive platform management interface.*

Overview

This skill provides end-to-end Flow Nexus platform management: user authentication, sandbox creation and execution, app store publishing and deployment, credit handling, and coding challenges. It centralizes operational commands for sandboxes, templates, payments, analytics, and rewards to streamline development and billing. Use it to automate common platform tasks and manage resources programmatically.

How this skill works

The skill exposes concise API-style actions to register and authenticate users, create and configure sandboxes from templates, run code, collect logs, and manage lifecycle operations. It also supports publishing and deploying app templates, monitoring analytics, handling rUv credits and payments, and administering challenges and leaderboards. Each operation accepts parameters for environment variables, packages, timeouts, and metadata to enable repeatable, scriptable workflows.

When to use it

  • Provision isolated development or CI sandboxes quickly
  • Deploy or update templates and apps to production or staging
  • Automate user onboarding, password resets, and profile updates
  • Monitor usage, check analytics, and manage billing credits
  • Run coding challenges, submissions, and leaderboard tracking

Best practices

  • Choose the smallest suitable sandbox template to reduce costs (base vs full-stack)
  • Store secrets in env_vars and avoid embedding keys in source_code parameters
  • Include startup scripts and install_packages to make sandboxes reproducible
  • Publish templates with clear docs, examples, and semantic versioning
  • Enable auto-refill and monitor credit thresholds to avoid interruption

Example use cases

  • Create a node sandbox with required packages and a startup script for API development
  • Deploy an express-api-starter template with production environment variables and database URL
  • Publish a paid template and earn rUv credits when others deploy it
  • Run ML experiments in a python sandbox, then stop and delete to save credits
  • List active challenges, submit solutions programmatically, and track leaderboard positions

FAQ

How do I avoid unexpected credit charges?

Use the smallest templates, enable auto-refill with conservative thresholds, monitor user_stats and rUv_history, and delete unused sandboxes and storage promptly.

Can I integrate Claude Code or other LLMs in sandboxes?

Yes — include LLM keys (e.g., anthropic_key) in sandbox_configure env_vars and choose the claude-code template for integrated environments.