Contributor Quick Start

# 1. Fork the marketplace repository on GitHub
# Visit: https://github.com/the-architech-xyz/marketplace
# Click "Fork" button
 
# 2. Clone YOUR fork
git clone https://github.com/YOUR_USERNAME/marketplace.git
cd marketplace
 
# 3. Add upstream remote
git remote add upstream https://github.com/the-architech-xyz/marketplace.git
 
# 4. Create feature branch
git checkout -b feature/my-first-adapter

# 1. Install dependencies
npm install
 
# 2. Build marketplace
npm run build
 
# 3. Link for local development
npm link
 
# 4. Go to CLI directory (clone if you haven't)
cd ../
git clone https://github.com/the-architech-xyz/cli.git
cd cli
 
# 5. Install and build CLI
npm install
npm run build
 
# 6. Link marketplace to CLI
npm link @thearchitech.xyz/marketplace
 
# 7. Link CLI globally
npm link
 
# 8. Verify setup
architech --version
architech list-genomes  # Should list 6 genomes

cd marketplace
mkdir -p adapters/services/axios
mkdir -p adapters/services/axios/templates

{
  "id": "services/axios",
  "name": "Axios HTTP Client",
  "description": "Promise-based HTTP client for the browser and Node.js",
  "category": "services",
  "version": "1.0.0",
  "provides": ["http-client", "axios", "api-client"],
  "capabilities": {
    "http-client": {
      "version": "1.0.0",
      "description": "HTTP request capabilities"
    }
  },
  "dependencies": {
    "axios": "^1.6.0"
  },
  "devDependencies": {
    "@types/node": "^20.0.0"
  }
}

import { Blueprint, BlueprintActionType } from '@thearchitech.xyz/types';
 
export default function generateBlueprint(config: any) {
  return [
    // Create HTTP client configuration
    {
      type: BlueprintActionType.CREATE_FILE,
      path: '{{paths.shared_library}}http/client.ts',
      template: 'templates/client.ts.tpl'
    },
    
    // Create API utilities
    {
      type: BlueprintActionType.CREATE_FILE,
      path: '{{paths.shared_library}}http/api.ts',
      template: 'templates/api.ts.tpl'
    }
  ];
}

import axios from 'axios';
 
export const httpClient = axios.create({
  baseURL: process.env.NEXT_PUBLIC_API_URL || '/api',
  timeout: 10000,
  headers: {
    'Content-Type': 'application/json',
  },
});
 
// Request interceptor
httpClient.interceptors.request.use(
  (config) => {
    // Add auth token if available
    const token = localStorage.getItem('auth_token');
    if (token) {
      config.headers.Authorization = `Bearer ${token}`;
    }
    return config;
  },
  (error) => Promise.reject(error)
);
 
// Response interceptor
httpClient.interceptors.response.use(
  (response) => response,
  (error) => {
    console.error('HTTP Error:', error);
    return Promise.reject(error);
  }
);

import { httpClient } from './client';
 
export const api = {
  get: <T>(url: string) => httpClient.get<T>(url).then(res => res.data),
  post: <T>(url: string, data: any) => httpClient.post<T>(url, data).then(res => res.data),
  put: <T>(url: string, data: any) => httpClient.put<T>(url, data).then(res => res.data),
  delete: <T>(url: string) => httpClient.delete<T>(url).then(res => res.data),
};

# 1. Rebuild marketplace
cd marketplace
npm run build
 
# 2. Create test genome
cat > test-axios.genome.ts << 'EOF'
import { defineGenome } from '@thearchitech.xyz/marketplace/types';
 
export default defineGenome({
  version: '1.0.0',
  project: {
    name: 'test-axios',
    framework: 'nextjs',
  },
  modules: [
    { id: 'framework/nextjs', parameters: { typescript: true } },
    { id: 'services/axios', parameters: {} },  // ← Your new adapter!
  ]
});
EOF
 
# 3. Generate test project
cd ..
architech new ./marketplace/test-axios.genome.ts
 
# 4. Check generated files
ls -la test-axios/src/lib/http/
# Should show: client.ts, api.ts
 
# 5. Verify it builds
cd test-axios
npm install
npm run build  # Should succeed!

cd marketplace
 
# Stage your adapter files
git add adapters/services/axios/
 
# Commit with conventional commit message
git commit -m "feat(adapter): add axios HTTP client adapter
 
- Provides HTTP client with interceptors
- Includes request/response utilities
- TypeScript typed
- Fully tested"
 
# Push to your fork
git push origin feature/my-first-adapter

## Module Type
- [x] Adapter
- [ ] Connector
- [ ] Feature
 
## Description
Adds Axios HTTP client adapter for making API requests.
 
## Capabilities
Provides: `http-client`, `axios`, `api-client`
Requires: (none)
 
## What This Adds
- HTTP client configuration with interceptors
- Typed API utilities (get, post, put, delete)
- Auto-adds auth tokens from localStorage
- Error handling
 
## Testing
- [x] Generated test project successfully
- [x] Project builds without errors
- [x] TypeScript types are correct
- [x] Template files are valid
 
## Files Added
- adapters/services/axios/adapter.json
- adapters/services/axios/blueprint.ts
- adapters/services/axios/templates/client.ts.tpl
- adapters/services/axios/templates/api.ts.tpl