# allcoderelay_mit

**Repository Path**: binghe021/allcoderelay_mit

## Basic Information

- **Project Name**: allcoderelay_mit
- **Description**: No description available
- **Primary Language**: Dart
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-18
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AllCodeRelay

Universal code scanner with webhook integration.

Developed by [Grapph](https://grapph.com)

Download on [Google Play](https://play.google.com/store/apps/details?id=com.grapph.allcoderelay)

Download on [App Store](https://apps.apple.com/us/app/allcoderelay-qr-barcode-nfc/id6753862179)


![AllCodeRelay](acr.jpg)

AllCodeRelay is a Flutter mobile application that serves as a universal code scanner with webhook integration capabilities.

## Features

- Multi-format, QR Code and Barcode scanning
- NFC tag reading
- Webhook integration for sending scanned data
- Secure storage of webhook URLs
- Customizable settings

*Webhook integration:* Automatically sends scanned data to configured endpoints via HTTP POST

*Secure configuration:* Uses Flutter Secure Storage for webhook URLs and supports custom headers

*Flexible settings:* Continuous scanning, scan delays, audio feedback, dark mode

*Local storage:* SQLite database for storing scan history when webhooks fail

*Architecture:* Built with Flutter 3.24+ using modern state management (BLoC pattern)

Navigation handled by `go_router`

Modular design with separate screens for home, settings, and about

## Workflow
 - User scans codes using the camera or NFC
 - App sends scan data to configured webhook endpoint
 - Server processes and returns structured response
 - App displays results or stores locally if webhook fails
 - The app is designed for enterprise/automation use cases where scanned codes need to be processed by external systems in real-time.


## Getting Started

This Flutter application requires Flutter 3.24 or higher.

### Prerequisites

- Flutter SDK (3.24+)
- Dart SDK (3.7.2+)
- Android Studio / Xcode for mobile deployment

### Installation

1. Clone the repository
2. Run `flutter pub get` to install dependencies
3. Connect a device or start an emulator
4. Run `flutter run` to start the application

## Dependencies

- mobile_scanner: For 2D/3D code scanning
- nfc_manager: For NFC reading
- http: For webhook communication
- flutter_bloc: For state management
- go_router: For navigation
- flutter_secure_storage: For secure storage of webhook URLs
- And more (see pubspec.yaml for complete list)

## Usage

Scan QR codes, barcodes, or NFC tags and relay the data to configured webhook endpoints.

## Webhook Integration

AllCodeRelay sends scanned data to your configured webhook endpoint via HTTP POST requests.

### Configuration

You can configure webhook settings in the app:

- **Webhook URL**: The endpoint that will receive scan data
- **Webhook Title**: A friendly name for your endpoint
- **Custom Headers**: Add authentication tokens or other required headers

### QR Code Configuration

Configure the app by scanning a special QR code with this format:

```
allcoderelay://setwebhookurl?url=https://your-webhook.com&title=My%20Webhook&headers={"Authorization":"Bearer%20token","Content-Type":"application/json"}
```

Use our [webhook configuration tool](https://grapph.com/allcoderelay/webhook_config.php) to easily generate these QR codes.

### POST Request Format

When a code is scanned, the app sends a POST request with this structure:

```json
{
  "code": "SCANNED_CODE_VALUE"
}
```

### Expected Response

Your webhook should return a JSON response with this structure:

```json
{
  "code": "SCANNED_CODE_TYPE",
  "codevalue": "PROCESSED_VALUE"
}
```

Where:

- `code`: Type of code scanned (e.g., "QR", "BARCODE", "NFC")
- `codevalue`: The processed value or meaning of the code

If the server returns a non-200 status code or the response cannot be parsed, the app will store the scan locally.

### Default Webhook

The app comes with a default webhook URL set to `https://n8n.grapph.com/webhook/allcoderelay`. This webhook is designed to work out-of-the-box and can be used for testing purposes.

This n8n workflow provides several intelligent responses based on the scanned code:

- EAN 13 Barcodes: Returns a link to product information
- NFC Door Tags: Returns a link to open the door
- Other QR, Aztec, or Data Matrix Codes: Uses AI to analyze and provide information about the scanned code

The workflow includes:

- code type detection
- integration with OpenAI for AI analysis
- SerpAPI for product information lookup
- conditionals for different code types

You can view an example of this [workflow](https://grapph.com/allcoderelay/allcoderelay.json) in the n8n workflow file included with this documentation.

To use this workflow, you need to:

- Import the workflow into n8n
- Set the OpenAI and SerpAPI API keys in the workflow
- Update the webhook URL in the app to point to your n8n instance

![n8n webhook](https://grapph.com/allcoderelay/n8n_webhook.png)

### Another funny webhook worth to test

<img src="assets/images/qrwebhook2.png" height="300" />

### Example Implementation

A simple PHP webhook endpoint:

```php
<?php
header('Content-Type: application/json');

// Get the POST data
$input = file_get_contents('php://input');
$data = json_decode($input, true);

// Process the scanned code
$scannedCode = $data['code'] ?? '';

// Return the processed data
echo json_encode([
  'code' => 'QR',
  'codevalue' => 'Processed: ' . $scannedCode
]);
?>
```

## GALLERY

See interesting gallery of webhook examples and use cases. Feel free to contribute!

[AllCodeRelay webhook gallery](https://github.com/miloswikarski/allcoderelay_mit/tree/main/webroot/gallery/)



## Contact

Email: allcoderelay@grapph.com