Skip to main content

Development Setup

This guide covers setting up a development environment for contributing to the Corelix platform.

Prerequisites​

  • PHP 8.4+
  • Composer
  • Node.js 18+ (for the MCP server)
  • Docker and Docker Compose
  • Git

Getting Started​

1. Clone the Repository​

git clone https://github.com/amirhmoradi/coolify-enhanced.git
cd coolify-enhanced

2. Install Dependencies​

composer install

3. MCP Server Development​

The MCP server is a standalone TypeScript project:

cd mcp-server
npm install
npm run dev  # Watch mode

4. Running Tests​

# Run all tests
./vendor/bin/pest tests/

Project Structure​

The Corelix platform is a Laravel package that extends Coolify v4. Key directories:

  • src/ — Package source code (services, models, policies, Livewire components)
  • config/ — Package configuration and feature registry
  • mcp-server/ — Standalone TypeScript MCP server (148 tools)
  • docs/ — Documentation

For contributor workflows, build scripts, and advanced development topics, see the repository's CONTRIBUTING guidelines.

Contributing​

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Follow the existing code style and patterns
  4. Add tests for new features
  5. Update documentation
  6. Submit a pull request

For more details, see the repository's CONTRIBUTING guidelines.