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:
- Self-use – Run it for your own restaurant or café group.
- 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
- Copy .env.example → .env and fill in all secrets
- Set DATABASE_URL for PostgreSQL
- Set a strong AUTH_PASSWORD_PEPPER (minimum 32 characters)
- Configure Super Admin bootstrap credentials
- Add your Brevo API key + the 6 template IDs
- 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
| Author | himanshusagar |
|---|---|
| Category | Scripts & Code / NodeJS |
| Price | $69 |
| Extended License | $207 |
| Likes | 1 |
| First Release | Sep 23, 2026 |
| Last Update | Sep 23, 2026 |
| Database | PostgreSQL 16 |
| Files included | .sql, .md, .yml/.yaml, package.json, Dockerfile, JavaScript .js |
| Software version | Node.js 22 |
| Software framework | React, Express.js |
| Javascript framework | React, Express.js, Node.js |
Categories
Tags
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.
Products of the Week.
Submit🥇
Perceptle
Perceptle is a daily browser-based game that challenges you to test your sensory intuition through five quick estimation and rhythm-based rounds.
Other · 3,957 views · 16 clicksOther · Week 47 · 3,957 views · 16 clicks
🥈
Free LinkedIn Likes From Real
Get free LinkedIn likes on your posts from real members who react by hand. No
SaaS · 4,075 views · 18 clicksSaaS · Week 47 · 4,075 views · 18 clicks
🥉
STOP GUESSING WHAT TO POST
AI that learns your brand voice and builds a month of consistent, on-brand social content: carousels, posts and hooks that sound like you, not like everyone else's AI.
SaaS · 11,557 views · 80 clicksSaaS · Week 47 · 11,557 views · 80 clicks
#4
aaas.market
407 reliable micro tools for solo founders, marketers and creators. They work in your browser
SaaS · 3,936 views · 7 clicksSaaS · Week 47 · 3,936 views · 7 clicks