Maxscripts symbol

CASE STUDY · RETAIL

Paint store point of sale on ERPNext

Working alongside the client’s ERP partner, we built a custom point-of-sale experience for a paint retailer: a fast React counter app inside ERPNext, backed by a synced colour catalogue, contractor job sites, card payments and automated end-of-day processes.

8POS screens, from sales and invoices to stock and vendors
1colour catalogue synced from the manufacturer’s data
Hourlyautomatic closing of open POS sessions
3 monthsof focused development

THE CHALLENGE

What needed to happen

Selling paint is not like selling boxed goods. Staff at the counter need to find the exact colour a customer wants among thousands of tints, know which finishes and samples are available, record which job site a contractor is buying for, and take payment quickly. The standard ERP point of sale was too generic and too slow for this, but all stock, pricing and accounting still had to stay in the client’s ERP.

WHAT WE DELIVERED

Every colour, every sale,
one counter.

01Counter app

Custom React point of sale

  • A fast sales screen embedded inside the ERP
  • Customer, product and payment sections designed for the counter
  • Invoice, customer, item, stock, purchase and vendor views
  • Receipts printed at the counter or sent to customers
02Product data

Paint colour & tint catalogue

  • Tint records with names, colour families, hex and RGB values
  • Catalogue synced from the paint manufacturer’s colour data
  • Sample SKUs, exterior availability and stain opacities
  • Generated colour swatches and images for screens and receipts
03Accounts

Contractor & customer management

  • Job-site addresses recorded against each customer
  • Customer validation rules on save
  • Automatic taxes, price lists and payment terms per customer
04Checkout

Payments & invoicing

  • Integrated card payments through a payment gateway
  • POS invoices consolidated into ERP sales invoices
  • A custom sales receipt format
  • Payment methods configured per POS profile
05Automation

Operations & data

  • Opening and closing entries for each register
  • Hourly automatic closing of POS sessions left open
  • Bulk imports of item prices and historical invoices from spreadsheets
  • Sign-out from all sessions for shared counter devices

ENGINEERING & OPERATIONS

  • A custom Frappe app using hooks, document events and method overrides instead of core changes
  • A React and TypeScript front end built with Vite and deployed as ERP assets by script
  • Custom fields and property setters shipped as fixtures for repeatable installs
  • Scheduled background jobs for end-of-day housekeeping
  • An API bridge between the React app and ERP business logic
  • Pre-commit checks with Ruff, ESLint and Prettier

WHAT IT MADE POSSIBLE

  • A counter experience built around how paint is actually sold
  • Exact colour data available at the point of sale
  • Contractor purchases tracked by job site
  • Faster checkout with integrated card payments
  • Stock, pricing and accounting kept in one system of record

TECHNOLOGY

Tools we used

ERPNextFrappePythonReactTypeScriptViteAnt DesignTailwind CSSMariaDBPayment gateway APIGoogle Sheets APIRuffESLintPrettier
All case studies ↗
Client name and confidential details withheld.

MORE WORK

Other case studies

Travel & hospitality · Case studyA members-only social travel platformAn end-to-end ecosystem that helps verified members discover, host and join trips, events and dining experiences, chat in real time, and book premium yachts, villas and restaurants.5connected productsiOS · Android · Webplatforms~150API endpointsRead the case study ↗Healthcare & life sciences · Case studyAI clinical decision support for integrative medicineAn AI clinical decision-support platform for traditional-medicine practitioners, combining evidence-cited case analysis, safety checks, research tools and full clinic management.50+source textsWeb · AI · APIsplatforms~140API endpointsRead the case study ↗HR & payroll · Case studyPayroll operations & workforce management suiteA payroll operations console and an employee self-service app that bring time tracking, scheduling, time off, payments and payroll documents together for employers and their teams.3connected appsWeb · iOS · Androidplatforms3languagesRead the case study ↗Telecom & messaging · Case studyWhite-label email marketing & delivery platformA white-label email platform for a business messaging provider: campaigns, templates, contact lists, transactional APIs and SMTP relay, sold to clients through a three-level reseller hierarchy.3role-based portals4servicesAPI · SMTPsending channelsRead the case study ↗Media & publishing · Case studyAd-free news reading with micropaymentsA consumer news app where readers unlock premium articles without ads or paywalls using a micropayment wallet, and can earn credit through brand offers, surveys and data sharing.iOS · Androidplatforms4environments2+ yearsof continuous releasesRead the case study ↗Real estate & proptech · Case studyProperty intelligence for real-estate investorsA mobile property intelligence app that lets real-estate investors explore parcels on a map, see ownership, tax and sales data, and manage deals from the field.iOS · Androidplatforms5property data views2.5 yearsof releasesRead the case study ↗Education & edtech · Case studyAI-powered exam preparation platform for dental studentsAn AI-powered learning platform that prepares dental students for their national board exam with case-based courses, timed mock exams, a searchable e-library and an AI study assistant.37screens~130API endpoints20+subject librariesRead the case study ↗Customer engagement · Case studyEmbeddable live chat for business websitesAn embeddable live-chat product that lets businesses add a branded chat widget to their website with one snippet, and answer visitors in real time from a shared web inbox.1snippet to embedReal-timemessaging18 monthsof developmentRead the case study ↗Events & exhibitions · Case studyTrade-show lead capture for exhibitorsA mobile CRM that helps exhibitors capture and qualify leads on the trade-show floor with voice notes that turn into text, photos, documents and a simple pipeline from pre-lead to converted.iOS · Androidplatforms20+screens5 monthsof developmentRead the case study ↗Energy & utilities research · Case studyMember research portal with AI-assisted searchAn enterprise Drupal platform for a research and advisory firm: a gated member research portal with personalised dashboards, single sign-on, Salesforce and events integrations, and AI-assisted research search.29custom modules3+ yearsof developmentDrupal · ReactstackRead the case study ↗

YOUR NEXT CHAPTER STARTS HERE

Have an idea?
Let’s make it happen.

Tell us what you’re thinking. We’ll start from there.

LET’S EXPLORE YOUR IDEA

A good place
to start.

Preview form: save your enquiry as a file. No message is sent, and no information is stored on a server.