Skip to main content

QR Code System

The ALXR QR Code Project is a lightweight system for generating, managing, and verifying attendance or user interactions through dynamic QR codes. It integrates a simple HTML front-end for user sign-up with powerful n8n automation workflows, which handle QR generation, email notifications, and Google Sheets storage.

Project Structure​


ALXRQRCode/
├── N8N/
│   ├── QRCode.json           # Main QR Attendance workflow for n8n
│   ├── QRCodeQA.json         # Query environment workflow
│
├── offer/
│   └── get-started.html      # Front-end sign-up / landing page
│
└── README.md                 # Project documentation

Overview​

This project connects front-end user sign-up with backend workflow automation to:

  • When there is a new joiner, a notification message will be sent to the QRCode Slack channel
  • Store user details automatically in a Google Spreadsheet for easy access and tracking
  • Send confirmation emails upon successful sign-ups

Setup Instructions​

1. Clone the repository​

git clone https://github.com/ALXRGroup/ALXRQRCode.git

2. Import n8n workflows​

  1. Open your n8n instance (self-hosted or cloud)

  2. Import the following workflows:

    • N8N/QRCode.json
    • N8N/QRCodeQA.json

  3. Update:

    • Webhook URL (matching your deployment)
    • Google Sheets credentials (under the Google Sheet node)
    • Email settings if you send confirmations

n8n Workflow Details​

** QRCode.json**​

Main workflow that:

  • Receives user details from the HTML sign-up form (POST /offer)
  • Stores the data in Google Sheets (e.g., Name, Email, Phone, Timestamp)
  • Sends a confirmation message and email.

QRCodeQA.json​

Testing version for internal QA:

  • Uses mock data
  • Runs without affecting production Google Sheets

offer/get-started.html​

Description​

This is a simple HTML form designed to capture essential user details such as:

  • Full Name
  • Phone Number
  • Email Address

The form submits data directly to your connected n8n webhook, where it triggers the automation that saves user information to Google Sheets and sends follow-up communication.

Hosting Requirement​

This form must be hosted on your own domain (e.g., https://offer.alxr.ai/get-started) because it serves as the entry point for customer pre-onboarding. Users may start their journey here — the data from this form powers the rest of your onboarding automation pipeline.

Customization​

  • Update brand colors in get-started.html
  • Modify Google Sheet structure (columns) in n8n
  • Add additional triggers or integrations (Slack)

License​

This project is licensed under the ALXR License.