@cappitolian/http-local-server

A Capacitor plugin to run a local HTTP server on your device, allowing you to receive and respond to HTTP requests directly from Angular/JavaScript.

Features

• Embed a real HTTP server (NanoHTTPD on Android, GCDWebServer on iOS).
• Receive requests via events and send responses back from the JS layer.
• CORS support enabled by default for local communication.
• Tested with Capacitor 7 and Ionic 8.

Installation

npm install @cappitolian/http-local-server
npx cap sync

Usage

Import

import { HttpLocalServer } from '@cappitolian/http-local-server';

Listen and Respond

// 1. Set up the listener for incoming requests
await HttpLocalServer.addListener('onRequest', async (data) => {
  console.log(`${data.method} ${data.path}`);
  console.log('Body:', data.body);
  console.log('Headers:', data.headers);
  console.log('Query:', data.query);

  // 2. Send a response back to the client using the requestId
  await HttpLocalServer.sendResponse({
    requestId: data.requestId,
    body: JSON.stringify({ 
      success: true, 
      message: 'Request processed!' 
    })
  });
});

// 3. Start the server
HttpLocalServer.connect().then(result => {
  console.log('Server running at:', result.ip, 'Port:', result.port);
});

Stop Server

// 4. Stop the server
await HttpLocalServer.disconnect();

Platforms

• iOS (Swift)
• Android (Java)
• Web (Returns mock values for development)

Requirements

• Capacitor 7
• Ionic 8 (optional, but tested)

License

MIT

Support

If you have any issues or feature requests, please open an issue on the repository.