ForgeFirst POS – Multi-Tenant GST POS NodeJS icon

ForgeFirst POS – Multi-Tenant GST POS NodeJS

Hot or Not
ForgeFirst POS – Multi-Tenant GST POS NodeJS

Description

ForgeFirst POS is a complete multi-tenant Point of Sale platform purpose-built for Indian restaurants and cafés.

One clean installation gives you a full Super Admin control plane plus unlimited restaurant accounts. Each restaurant runs as an isolated business with its own menu, tables, staff, GST settings, printers and QR ordering — while you stay in complete control from a single dashboard.

Designed for real Indian restaurant operations

  • Full GST-compliant billing with CGST/SGST calculation, multiple tax rates, GST reports and configurable charges
  • Dine-in, takeaway and delivery workflows in one place
  • Table management with floor-wise grouping and live status
  • KOT (Kitchen Order Ticket) with configurable copies and modification tracking
  • Kitchen Display System (KDS) for real-time kitchen preparation
  • Cash, UPI and card payments with split payments and automatic change calculation
  • Opening/closing cash reconciliation, expense tracking and payment corrections
  • Owner dashboard, sales reports, item performance and CSV exports

Captain App + Mobile Ready

The same POS works as a full captain/waiter app on phones and tablets. Staff can take orders, manage tables, send KOTs and track live status with a smooth, responsive interface — no separate app to maintain.

Silent Local & Remote Printing

The package includes a complete Windows Print Bridge for silent KOT and bill printing. Support both local printers and remote print stations. Devices pair securely with one-time codes, jobs are queued reliably, and printing happens without any popup dialogs.

DirectQR Table Ordering

Customers scan a table QR, browse the live menu, place orders and track status in real time. Includes customer accounts, CAPTCHA protection, rate limiting and a branded public ordering experience that can be fully customized per restaurant.

Multi-Tenant Architecture & Staff Control

  • Super Admin panel to create, suspend or manage any number of restaurants
  • Unlimited staff accounts with Owner, Manager, Cashier and Waiter roles
  • Granular permission matrix for every sensitive action
  • Support mode with scoped, audited sessions
  • Login activity tracking and full audit logs

How you can earn with white-label / SaaS

ForgeFirst is designed for two clear business models:

  1. Self-use – Run it for your own restaurant or café group.
  2. White-label SaaS – Rebrand it and sell it as your own multi-tenant POS platform to other restaurants.

As a white-label operator you can:

  • Charge restaurants a monthly or yearly subscription
  • Offer different plans (basic POS, POS + QR ordering, POS + Print Bridge, etc.)
  • Take a setup fee for onboarding and training
  • Sell additional services such as menu setup, printer configuration or custom branding
  • Scale to dozens or hundreds of restaurants from a single Super Admin installation

The source is fully editable. Simply replace logos, product name, favicon, email templates and customer-facing branding, then launch under your own domain. No seller-side activation server is required — you own and control the entire platform.

What’s included

  • Full source code (Node.js + React + PostgreSQL)
  • Windows Print Bridge (source + setup scripts)
  • GST-aware billing engine and reports
  • DirectQR public ordering pages
  • Super Admin + restaurant onboarding flow
  • Brevo transactional email templates
  • Deployment, security and white-label documentation

Whether you want a powerful POS for your own outlet or a ready-to-scale multi-tenant SaaS business, ForgeFirst gives you a complete, production-ready foundation.

Features

## 1. Platform

- Node.js 22 / Express 5 API - React 19 / Vite 7 web application - PostgreSQL-backed multi-restaurant architecture - npm workspace monorepo - One API process can serve the built web app and DirectQR public pages - REST-style JSON APIs with server-side validation - Server-Sent Events for live operational updates - Docker deployment support - Production health endpoint at `/api/health` - Host-agnostic deployment with PostgreSQL and HTTPS

## 2. Super Admin control plane

The Super Admin is the operator's control plane for provisioning and managing restaurants.

### Authentication

- Username/password login - Email OTP step using Brevo - Login activity tracking - Session limits, inactivity/expiry handling and revocation - Optional exact-IP allowlisting

### Restaurant management

- Create a restaurant/café - Configure restaurant name, QR slug and owner details - Generate temporary onboarding credentials - Show temporary credentials only once - Track temporary-password expiry - Manage restaurant lifecycle state: Setup Pending, Active, Suspended and Disabled - Revoke restaurant-user sessions when an outlet is suspended/disabled

### Restaurant detail tabs

- Overview - Commercials & QR - Support Mode - Audit log

### Support Mode

- Scoped support sessions with explicit MENU and/or SETUP scopes - Configure menu categories/items - Bulk menu-item creation - Configure table categories/tables - Support actions are audited

## 3. Restaurant onboarding

The source includes a setup checklist covering:

- Restaurant basics - Email verification - Owner account - Temporary owner credential replacement - Menu - Tables - GST and billing - Printer test - QR setup - Staff training - Go-live

Restaurant provisioning creates default T1–T4 tables through the database trigger/migration path.

## 4. POS roles and permissions

Current restaurant-side roles include:

- Owner - Manager - Cashier - Waiter

Permissions cover operations such as table viewing, order creation, KOT, billing, payments, reports, menu editing, table management, delivery, discounts, GST/charges, expenses, closing, payment corrections, KOT preparation, audit logs, staff accounts and QR downloads.

The permission matrix is enforced server-side; hiding a button in the UI is not the only authorization layer.

## 5. Order entry

The POS supports restaurant order workflows around:

- Dine-in orders - Takeaway orders - Delivery orders - Table selection for dine-in - Customer name/mobile details - Delivery address details - Delivery riders/statuses - Order instructions/notes - Item quantities - Item add-ons - Multiple item sizes - Item availability - Live table/order states

## 6. Menu management

Menu items support:

- Category assignment - Name and description - Price - GST rate - Availability/active state - Add-on groups/options - Item sizes with individual prices and a selected default size - Bulk item creation

## 7. Indian tax and billing

The shared `pos-core` tax logic handles INR/paise-safe calculations and GST-aware bill totals.

Current billing-related functionality includes:

- GST registration state - GSTIN/business details - CGST/SGST display - Multiple GST-rate handling - Taxable/non-taxable calculations - Delivery charge GST - Container charge GST - GST reports - Bill configuration and purchase/billing settings - Indian mobile-number validation in relevant customer flows

GST and charge settings can be permission-gated and are available to Owner/Manager flows according to the current permission matrix.

## 8. Payments

The order/payment flow supports:

- Cash - UPI - Card - Split payments - Payment matching against bill total - Cash received/change calculation - Payment corrections with permission controls - Payment-correction audit history

## 9. KOT, kitchen and billing print workflow

- KOT creation and reprint - KOT modification workflow - Configurable KOT display fields - Configurable first/modified/additional KOT copy counts - Kitchen preparation status updates - Mark KOT prepared - Bill printing/reprinting - Kitchen Display/KOT preparation permissions - Standard, Kiosk, local-bridge and remote-print-relay modes exposed in Printing settings

## 10. Windows Print Bridge

The repository includes source for a Windows desktop Print Bridge under `tools/ForgeArc.PrintBridge/`.

Current bridge integration includes:

- Local printer discovery - Windows printer submission - Silent local printing workflow - Remote print relay workflow - KOT/Bill station assignment - Pairing-code authentication - Device-specific credentials - Device revocation - Queue/retry behavior through the API's durable print-job system - Tray/startup setup scripts

The bridge is a separate optional desktop component; it is not required for browser-only use.

## 11. Operations workspace

Current released Operations sections include:

- Delivery Riders - QR Codes - QR Website Settings - GST & Charges - Expense Tracker - Closing Note - Payment Correction - Table Management - KOT & Bill - Audit Logs

The current UI also shows these three areas as **Coming Soon**, not released inventory features:

- Recipe & Inventory - Discounts & Offers - Cost & Price Calculator

They should not be advertised as implemented functionality in a marketplace listing.

## 12. Tables and QR ordering

### Table management

- Table categories - Table creation/edit/delete controls - Default T1–T4 table creation at restaurant provisioning - Table-specific QR links when QR Ordering is active

### DirectQR ordering

- Public restaurant menu and order context - Customer account registration/login - CAPTCHA on customer registration - QR order request submission - Customer order status access - Restaurant-side QR order queue - Accept/reject actions - Merge accepted QR order into the corresponding table/open restaurant order workflow - Configurable pending-order TTL - Live updates through the event stream where enabled

## 13. Branded QR website

When the Branded QR entitlement is active, the restaurant can configure a public customer-facing QR website with:

- Hero tagline and sub-tagline - Call/WhatsApp contact numbers - Instagram, Swiggy, Zomato and Google review links - Directions link - Weekly opening/closing hours - About section - Gallery (with upload, resize and limits) - Theme/color palette selection - Restaurant logo - Preview/save workflow

## 14. Dashboard and reporting

### Owner dashboard

- Current/period sales performance - Live activity - Best-selling item visibility - Sales distribution by hour - Operational metrics

### Standard Reports

The current reports workspace includes:

- Executive Sales Summary - Sales Summary - Item Summary - GST Report - Void Orders - Customer Details (permission-controlled)

Reports support date/order/payment-related filtering where applicable and CSV export on supported reports.

### Advanced Insights

Feature-gated advanced reporting includes:

- Overview - Item Performance - Category Performance - Sales Trend - Hourly/Daypart analysis - Discount & Staff Control - QR Performance when DirectQR is enabled

The advanced reporting implementation is intended to use settled, non-voided order data for its primary sales/insight calculations.

## 15. Staff and security administration

Settings include:

- Business details - Printing - Purchase details - Void-password controls - Staff accounts - Role/permission management

Staff-account controls include creation, editing, password reset, activation/deactivation and permission assignment subject to the logged-in administrator's permissions.

## 16. Support and auditing

- Support tickets are available when the relevant Support entitlement is current. - Super Admin can view/close support tickets. - Login activity is exposed to Super Admin. - Restaurant audit logs record sensitive operational/security actions. - Support sessions have explicit scopes and are auditable.

## 17. Transactional email

Brevo is integrated for:

- Restaurant email verification - Admin password reset - Super Admin password reset - Admin password changed confirmation - Super Admin password changed confirmation - Super Admin login OTP

Editable template files are included under `Brevo Email templates/`.

## 18. Public/customer security controls

DirectQR customer flows include:

- Account/password authentication - CAPTCHA challenge - CSRF protection for customer mutations - Session cookies - Login/registration rate limits - Phone/device-oriented abuse controls - Public QR pending-order expiry - Explicit consent/policy acceptance records

Requirements

Core Requirements

  • Node.js 22.16.0
  • PostgreSQL 16 (or compatible)
  • Production HTTPS endpoint (required for security features)
  • Brevo account + API key (for transactional emails: verification, password reset, Super Admin OTP)

Optional but Recommended

  • Windows 10/11 machine (for the included Print Bridge if you want silent local/remote KOT & bill printing)

What you need to configure

  1. Copy .env.example → .env and fill in all secrets
  2. Set DATABASE_URL for PostgreSQL
  3. Set a strong AUTH_PASSWORD_PEPPER (minimum 32 characters)
  4. Configure Super Admin bootstrap credentials
  5. Add your Brevo API key + the 6 template IDs
  6. Use HTTPS in production

Basic deployment steps

Bash

npm ci
npm run db:schema
npm run db:migrate
npm run build
npm run start:production



That’s everything required to get the multi-tenant POS running.

Instructions

please read the deployment-guide.md and brevo-setup.md file

use these credentials for demo  on pos.forgefirst.in

staff login -> some features are disabled on demo for security purposes

restaurant id : FA270E2A28539428

username :  sarvarth001

pwd : Qwerty@12345

Authorhimanshusagar
CategoryScripts & Code / NodeJS
Price$69
Extended License$207
Likes1
First ReleaseSep 23, 2026
Last UpdateSep 23, 2026
DatabasePostgreSQL 16
Files included.sql, .md, .yml/.yaml, package.json, Dockerfile, JavaScript .js
Software versionNode.js 22
Software frameworkReact, Express.js
Javascript frameworkReact, Express.js, Node.js

External listing. code.market does not sell this product and does not process payment for it. Pricing, payment, delivery, licensing, refunds, and support are handled by the third-party merchant on its own website. We may earn an affiliate commission from a referral. Details.