This POS app, with its administrative panel, was meant to be a simple to use alternative to all the restrictive paid apps for small shops, street fairs, and neighborhood festivals.
This app was built with Go 1.16, so make sure you have that installed.
git clone https://github.com/wisepythagoras/pos-system && cd pos-system
make current_archIf the build completes without any issues, you should have an executable file in ./bin:
./bin/pos-system
Then build the front end apps:
yarn build && yarn build-adminNow you can access the POS app via http://localhost:8088.
The only dependency that this application has is wkhtmltopdf (you can find information about it here), if you want to be able to print receipts (which you should). The website provides downloadable packages for many systems. However, if you are using Ubuntu or Debian, you can install it by running the following command:
sudo apt install wkhtmltopdfIf you wish to deploy the app, you can use a $35 Raspberry Pi running Raspberry Pi OS Lite or Ubuntu Server, if you wish to have a 64-bit version.
You can create a dedicated Wi-Fi network and connect the Raspberry Pi directly to the router. After that, you'll have to drop this source directory somewhere (see the [Building] section) and create a config.yaml file following the example in config.example.yaml. Then direct your tablet(s) to http://localhost:8088. That's it!
This app was built to use a CUPS server. You can connect your thermal printer to the Raspberry Pi you have this server running on, or to some other machine, and tell the POS app where to find it via the config file.
Make sure that your printer settings are valid. You can check the settings by navifating to to http://your-server-ip:631 and under the "Printers" tab select your printer. From there, click on the second dropdown menu and click on "Set Default Options", as shown in the screenshot below.
There is an admin panel for creating and deleting users, but updating them is not supported at the moment. You can either delete the previous user and re-create one, or update the user record in the database. Simply open pos.db with SQLite Database Browser, or any other app that can open sqlite databases, and then click on the "Execute SQL" tab or go to the "Browse" tab and update the record you wish.
You can fully manage your products from the "Products" tab in the admin page, as well as create new ones. However, you also have the flexibility of doing this through the API. The following curl is an example of how to create a new product.
curl -X POST http://localhost:8088/api/product -d 'name=Product Name&price=$9.99&type=food' -H 'x-auth-token: YOUR_ADMIN_AUTH_TOKEN'Currently, the app only supports the following product types: food, drink, pastry, but this is subject to change at any moment.
Read this guide.
- Receipt printer support.
- Manage products from the admin panel.
- Manage users through the admin panel.
- Allow cashiers to select between multiple printers.
- Separate app/page for stations to fulfill orders.
- Extension/module engine.