CAROMAR

Copy A Repository Or Merge All Repositories

A powerful web application that allows users to efficiently manage GitHub repositories by either forking individual repositories or merging multiple repositories into a single repository with organized folder structure.

Deploy CAROMAR to Netlify with one click:

📖 Full Deployment Guide

• Secure GitHub Personal Access Token integration
• User profile validation and display
• Token storage for session persistence

• Search repositories by GitHub username
• Support for both personal and other users' repositories
• Comprehensive repository information display
• Language detection and visual indicators

• Interactive repository grid with checkboxes
• Bulk selection controls (Select All/Deselect All)
• Real-time selection counter and status updates

• Fork each selected repository individually to your GitHub account
• Preserves original repository structure and history
• Batch processing with progress tracking
• Error handling for failed forks

• Creates a new destination repository and provides validated, credential-free local git commands to add each selected repo as its own folder
• Each source repository becomes a main folder
• Maintains separation while creating unified access
• Custom naming for the merged repository

• Real-time progress bars during operations
• Detailed status messages
• Comprehensive results display with success/error reporting
• Direct links to newly created repositories

• Responsive design for desktop and mobile devices
• Modern, clean interface with GitHub-inspired styling
• Intuitive workflow with step-by-step guidance
• Error notifications and success confirmations

• Per-token and per-IP rate limiting on every API route
• Prototype-pollution guard on all request bodies
• Configurable CORS origin allowlist (ALLOWED_ORIGINS)
• Content-Type enforcement on state-changing endpoints
• See SECURITY.md for the full policy

• Node.js (v18 or higher)
• npm (v9 or higher)
• GitHub Personal Access Token

1. Clone the repository:

   git clone https://github.com/Universal-Standard/CAROMAR.git
   cd CAROMAR

2. Install dependencies:

   npm install

3. Set up environment variables (optional):

   cp .env.example .env
   # Edit .env with your configuration

4. Validate deployment configuration:

   npm run validate

5. Start the application:

   npm start

6. Open your browser: Navigate to http://localhost:3000

For development with auto-restart on file changes:

npm run dev

Option 1: One-Click Deploy

1. Click the "Deploy to Netlify" button above
2. Configure your site name
3. Deploy!

Option 2: Manual Deploy with CLI

# Install Netlify CLI
npm install -g netlify-cli

# Login to Netlify
netlify login

# Deploy
netlify deploy --prod

Option 3: GitHub Integration

1. Push to GitHub
2. Connect repository in Netlify Dashboard
3. Automatic deployments on every push

📖 See Netlify Deployment Guide for detailed instructions

1. Visit the CAROMAR web application
2. Click "Create Personal Access Token" to generate a GitHub token
3. Enter your token and click "Validate Token"
4. Your GitHub profile will be displayed once validated

1. Enter a GitHub username (yours or another user's)
2. Click "Search Repositories" to load their repositories
3. Browse the repository grid with detailed information

Choose between two operation modes:

Fork Individual Repositories:

• Select repositories you want to fork
• Each will be forked individually to your account
• Maintains original repository structure

Merge into Single Repository:

• Select multiple repositories to combine
• Enter a name for the merged repository
• Creates the destination repository and provides local/manual merge steps for adding each selected repo as a folder

1. Select your desired repositories using checkboxes
2. Use "Select All" or "Deselect All" for bulk operations
3. Click the "Execute" button to start the process
4. Monitor progress with real-time status updates

• View detailed results of the operation
• Access direct links to newly created repositories
• For merge operations, complete the provided local/manual git steps before treating the merge as finished
• Review any errors or issues encountered

To use CAROMAR, you need a GitHub Personal Access Token:

1. Go to GitHub Settings > Developer settings > Personal access tokens
2. Click "Generate new token (classic)"
3. Select appropriate scopes:
   • ✅ repo (for repository access)
   • ✅ user (for user information)
4. Copy the generated token
5. Enter it in the CAROMAR application

Security Note: Your token is stored locally in your browser and used only for GitHub API calls. It's never sent to external servers.

The application provides several REST API endpoints:

• GET /api/user - Get authenticated user information
• GET /api/validate-token - Validate GitHub token and permissions

• GET /api/search-repos - Search repositories for a user
• POST /api/fork-repo - Fork a specific repository
• POST /api/create-merged-repo - Create merged repository
• GET /api/repo-content - Get repository content preview

• POST /api/analyze-repos - Analyze repository statistics
• POST /api/compare-repos - Compare multiple repositories

• GET /api/health - Health check endpoint
• GET /api/metrics - Performance metrics

📖 See API Documentation for detailed API documentation

• HTML5, CSS3, Vanilla JavaScript
• EJS templating engine
• Responsive design
• Real-time progress tracking

• Node.js (v18+)
• Express.js
• Serverless-ready architecture
• RESTful API design

• Netlify Functions (Serverless)
• Netlify CDN (Static assets)
• GitHub REST API v3 integration

• Jest (Testing)
• ESLint (Linting)
• Nodemon (Development)

CAROMAR/
├── .github/
│   ├── ISSUE_TEMPLATE/       # Bug/feature report templates
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── workflows/
│       ├── ci.yml            # Lint, test, and deployment validation
│       └── codeql.yml        # Static security analysis
├── docs/                     # Full documentation set
│   ├── README.md             # Documentation index
│   ├── guides/                # quickstart.md, setup.md, development.md
│   ├── deployment/            # netlify.md, environment.md
│   └── api/                   # endpoints.md
├── public/                   # Static assets (served from CDN)
│   ├── css/
│   │   ├── style.css         # Application styling
│   │   └── icons-fallback.css # Icon fallbacks
│   ├── js/
│   │   ├── app.js            # Simplified reference frontend
│   │   └── enhanced-app.js   # Full-featured frontend (used in production)
│   ├── robots.txt            # SEO crawler rules
│   └── sitemap.xml           # SEO sitemap
├── views/
│   └── index.ejs             # Main HTML template
├── functions/
│   └── server.js             # Netlify serverless wrapper
├── utils/
│   ├── analytics.js          # Repository analytics
│   ├── comparison.js         # Repository comparison
│   ├── logger.js             # Logging utility
│   ├── validation.js         # Input validation
│   ├── performance.js        # Performance monitoring
│   └── security.js           # Security utilities (rate limiting, sanitization, CORS)
├── scripts/
│   ├── validate-deployment.js # Pre-deploy validation
│   └── monitor-deployment.js  # Post-deploy health monitoring
├── tests/
│   ├── app.test.js
│   ├── merge-contract.test.js
│   ├── security.test.js
│   ├── server.test.js
│   ├── token-security.test.js
│   └── utils.test.js
├── server.js                 # Express application
├── package.json               # Dependencies & scripts
├── package-lock.json
├── netlify.toml               # Netlify configuration
├── .nvmrc                     # Node version
├── jest.config.js
├── eslint.config.js
├── .env.example
├── .gitignore
├── README.md                  # This file
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
└── LICENSE

npm start              # Start production server
npm run dev            # Start development server with auto-reload
npm test               # Run tests
npm run test:watch     # Run tests in watch mode
npm run test:coverage  # Generate coverage report
npm run lint           # Check code quality
npm run lint:fix       # Fix linting issues
npm run build          # Build for production
npm run validate       # Validate deployment configuration
npm run monitor        # Health-check a deployed instance
npm run predeploy      # Pre-deployment checks (lint + test)

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Watch mode for development
npm run test:watch

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📖 See CONTRIBUTING.md for detailed guidelines

Quick Links:

• Quick Start Guide - Get started in 5 minutes
• Setup Guide - Detailed installation instructions
• Development Guide - Architecture and development
• API Documentation - Complete API reference
• Netlify Deployment - Deploy to Netlify
• Environment Config - Configuration guide

Project Documentation:

• CONTRIBUTING.md - Contribution guidelines
• SECURITY.md - Security policy
• CHANGELOG.md - Version history

This project is licensed under the MIT License - see the LICENSE file for details.

If you encounter any issues or have questions:

1. Check Documentation:

   • Documentation Index
   • Quick Start Guide
   • Deployment Guide
   • API Documentation

2. Search Issues:

   • Check existing issues

3. Create New Issue:

   • Report a bug
   • Include error messages and steps to reproduce

• GitHub Discussions: Ask questions and share ideas
• Issue Tracker: Report bugs and request features

• GitHub API for repository management capabilities
• Netlify for serverless hosting platform
• Font Awesome for icons
• Express.js for backend framework
• Modern web standards for responsive design

✅ Production Ready
✅ Deployment Tested
✅ Fully Documented
✅ Security Hardened (rate limiting, prototype-pollution guard, CORS allowlist, and CSP wired in and exercised by tests — see CHANGELOG.md)

Built with ❤️ by Universal-Standard