🌉 Bridge CLI

Write your logic once. Compile it everywhere.

Bridge lets you define business logic in a clean .bridge syntax and compile it into PHP (Laravel), TypeScript, and Node.js (ESM) — all from a single source of truth.

---

Table of Contents

• Installation
• Quick Start
• Commands
• The .bridge Syntax
• Configuration
• Output Examples
• Reverse Compilation
• VS Code Extension

---

Installation

npm install -g @cas8398/bridge-cli

Verify the install:

bridge --help

---

Quick Start

# 1. Create a new project
bridge new my-app
cd my-app

# 2. Edit your logic
# src/logic.bridge is created automatically — open it and define your functions

# 3. Compile to all targets
bridge build

After bridge build, your outputs land in .bridge/:

my-app/
├── .bridge/
│   ├── php/        ← Laravel-ready PHP class
│   ├── ts/         ← TypeScript with typed signatures
│   └── node/       ← Node.js ESM module
├── bridge.config.json
└── src/
    └── logic.bridge

---

Commands

Command	Description
bridge new <name>	Scaffold a new Bridge project
bridge build	Compile all .bridge files in src/ to configured targets
bridge to-bridge <file>	Reverse-compile a PHP or TS file back into .bridge syntax
bridge help	Show available commands

---

The .bridge Syntax

Bridge uses a TypeScript-like syntax with a small set of familiar types.

function calculateTotal(price: float, tax: float): float {
  let total = price * (1 + tax)
  return total
}

Supported types

Bridge type	PHP	TypeScript / Node
float	float	number
int	int	number
string	string	string
bool	bool	boolean

---

Configuration

bridge.config.json controls what gets compiled and where:

{
  "src": "src",
  "outDir": ".bridge",
  "targets": ["php", "ts", "node"],
  "preserveName": true
}

Field	Default	Description
src	"src"	Directory containing your .bridge source files
outDir	".bridge"	Output directory for compiled files
targets	["php","ts","node"]	Compile targets — any combination of php, ts, node
preserveName	true	Keep the original filename casing in output

---

Output Examples

Given this source:

// src/logic.bridge

function calculateTotal(price: float, tax: float): float {
  let total = price * (1 + tax)
  return total
}

TypeScript (.bridge/ts/logic.ts)

/**
 * Generated by Bridge from logic.bridge
 */

export function calculateTotal(price: number, tax: number): number {
  let total = price * (1 + tax);
  return total;
}

Node.js ESM (.bridge/node/logic.js)

/**
 * Generated by Bridge from logic.bridge
 * Target: Node.js (Bare JavaScript)
 */

export function calculateTotal(price, tax) {
  let total = price * (1 + tax);
  return total;
}

PHP / Laravel (.bridge/php/Logic.php)

<?php

namespace App\Bridge;

/**
 * Generated by Bridge
 */
class Logic
{
    public function calculateTotal(float $price, float $tax): float
    {
        $total = $price * (1 + $tax);
        return $total;
    }
}

---

Reverse Compilation

You can reverse an existing PHP or TypeScript file back into .bridge syntax:

bridge to-bridge .bridge/php/Logic.php

The reversed file lands in .bridge/to-bridge/. Move it to src/ to include it in future builds:

mv .bridge/to-bridge/Logic.bridge src/

Note: to-bridge works best on files that were originally compiled by Bridge. Hand-written PHP or TS with complex patterns may not reverse cleanly.

---

VS Code Extension

Get syntax highlighting and snippets for .bridge files:

👉 Bridge Language Support on the VS Code Marketplace

---

License

MIT