Awesome Open Source
Awesome Open Source


TailPOS an Offline First Open Source POS for ERPNext

Get it on Google Play




o Two-way Sync to ERPNext Two-way syncing to an ERPNext instance for a full suite of back-office functionalities.

o Offline-first Approach Continue to make sales and keep running the business even no internet or unstable.

o Mobile POS Uses the tablet for a lightweight setup. Built-in rear camera of the tablet can be used as a barcode scanner. Any bluetooth barcode scanner is compatible with tailpos

o Print receipts Print sales receipts for customers using any ESC/POS receipt printer.

o Multiple payment modes Can process credit card,mobile payments and cash.

o Discounts Program Can apply discount to an invoice or on specific items.

o Inventory Management Keep track of stock levels easily. Easy-to-use menu for item maintenance such as creating and updating item information.

o Sales Reports Can generate X and Z readings and attendant shift sales totals.


This project is released under the GPLv3 license, for more details, take a look at the LICENSE file in the source.

Quick Start

A quick demo of syncing the tailpos to a Frappe/Erpnext server

Login to demo server
username: [email protected]
password: @Bailabs
Making a new item.
  • Go To Item List.
  • Make a new Item.
  • Select your new Itemto see its properties.

alt text

  • Select Item Price under Pricing. Make sure the In TailPOS checkbox is checked.

alt text

  • Don't forget to save your Item.
Setup TailPOS Sync Settings
  • Go to Settings > Sync
  • Fill the following
ERPNext Server:
Username: [email protected]
Password: @Bailabs
Device ID: <>

Setting up device ID

  • Go to Device list.
  • Create a new Device
  • Input the Device Name and POS Profile
  • Fill out information need in the POS profile
Name: <>
Series: ACC-SINV-.YYYY.-

Write Off Accounting: Write Off – D
Write Off Cost Center: Main – D

alt text

alt text

  • Select your new Device.
  • Device ID is displayed at the top-right corner near the Save button.

alt text

  • Once your done, save your Sync Settings.
  • Press Force Sync.
  • Once Force Sync is successful, go to your Sales tab and fill up a sample transaction.
  • Confirm the transaction by looking at your Receipts tab.
  • Now go back to your Settings > Sync and Force Sync the receipt data to the server.
  • Verify by going to Receipts List in ERPNext and check the receipts if they are generated.

How To Compile TailPOS in your local machine

If you are interested contributing the tailpos, the following guide will give you instructions in compiling the tailpos.

First, you'll need nodejs and npm:

sudo apt install curl
curl -sL | sudo -E bash -
sudo apt-get install -y nodejs
nodejs -v

Install development tools to build native addons:

sudo apt-get install gcc g++ make

Install the yarn package manager, run:

curl -sL | sudo apt-key add -
echo "deb stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update && sudo apt-get install yarn

Then you can install react-native-cli using npm

sudo npm install -g react-native-cli

Now you need to install Java and Android

sudo apt-get install default-jre
sudo apt-get install default-jdk

sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer
  • Install Android
  • Install Android SDK requirements
cd ~
mkdir android-sdk
cd android-sdk
sudo apt-get install unzip

We add the path of our Android SDK tools to .bashrc so that we have access to the Android tools.

cd ~
nano .bashrc

# Add these lines to the top of the file
export ANDROID_HOME=$HOME/android-sdk
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools

# CTRL+O (uppcase o) to save
# CTRL+X to exit

source ~/.bashrc
android update sdk --no-ui
# Answer 'y' to all prompts

sdkmanager "platforms;android-23" "build-tools;23.0.1" "add-ons;addon-google_apis-google-23"

Installing TailPOS

cd ~
mkdir Projects
cd Projects
git clone
cd tailpos

Updating react-native-camera modules

  • remove buildscript section
  buildscript {
  repositories {
    maven {
      url ''

  dependencies {
    classpath ''
  • compileOnly to provided
  • implementation to compile
cd ~
nano Projects/tailpos/node_modules/react-native-camera/android/build.gradle

Updating react-native-maps modules

  • compileOnly to provided
  • implementation to compile
cd ~
nano Projects/tailpos/node_modules/react-native-maps/lib/android/build.gradle

Updating react-native-bluetooth-serial modules

  • remove @Override in line 23 (the second @Override)
cd ~
nano Projects/tailpos/node_modules/react-native-bluetooth-serial/android/src/main/java/com/rusel/RCTBluetoothSerial/

Updating react-native-device-info with support-v4 fix

ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:fontVariationSettings
ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:ttcIndex

Set the following under build.gradle under react-native-device-info

android {
  compileSdkVersion 26
  buildToolsVersion "26.0.2"

dependencies {
  compile ""
  compile ""

Update react-native-localization

  • implementation to compile

Building TailPOS

cd ~
cd Projects/tailpos
react-native run-android
Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,157,171
Reactjs (175,288
Offline (5,528
Mobile App (3,253
Pos (3,108
Barcode Scanner (408
Offline First (321
Mobx React (189
Point Of Sale (183
Erpnext (95