Small Business Fridge is a super simple system for sharing foods and drinks with colleagues, it offers simple, mostly intuitive UI, which offers what products are available, how many and for how much. Customers can buy product with one simple click. The only other thing they have to do is to take the product and consume it and pay it later with QR code.
This tool was exclusively developed for ourselves, colleagues in IT department, but we have commited to make it FOSS and hopefully configurable enough to allow others to use it if they want! There are however couple things that may need some customizations on your end, whether you fork it or open a pull request on this repository. The list of known gotchas:
- Authentication is written for Microsoft Entra ID (Azure Active Directory) with Passport.js - You are more than welcome to securely replace it with general OAuth/OIDC library
- Application is in czech language and there is no internalization package currently - Again, if you are willing to provide translations, we will try to implement it
- Application has the minimum required features required for our use case, that is sharing foods and drinks with no profit, thus no legal compliance typically required for businesses
- everything is available for both mobile and desktop
- shopping page displaying products in a very practical way
- display all your orders
- display invoices, their payment status and mark them as paid
- create and edit products
- add new categories and add products to categories
- add products to favorites to display them at the top
- stock products
- generate QR payments for your customers with single click to e-mail
- validate payments
- automatic payment reminders
- administer users, assign permissions and offboard users
- easily onboard users by integrating with SSO and auto-registration
- easily train users with simple documentation in app
- use kiosk interface to deploy self-checkout device next to products
- user sbf-scan mobile app to self-scan and self-checkout
The whole system is running on Node.js with Express.js framework and stores data in MongoDB. We have made everything in our power to secure this application by using Azure passport allowing you to use your company ID to login and manage everything. It should be pretty lightweight, as we run it on a potato without any problems for around 30 users.
Read Wiki for more detailed informations and getting started guides.
The 2.0.0 update brought so much life to our project in our office, that we had to develop even more features and also developed new sbf-scan mobile app, which allows users to take handheld scanner or even just smartphone and purchase multiple products by scanning codes from products.
This simple system is alive and kicking for 4 years already in our office! While imperfect, it has enabled us to share 4561 pieces of drinks and food in total cost of 79084 CZK in version 1.0.x. Version 1.0.x has been in use from 2019-09-07 to 2023-11-02 and since 2023-11-03 we have deployed version 2.0.0 and hope to keep going strong. Only time will tell, if everything is worknig as expected and whether we need to develop additional updates. Most likely we will.
- To develop main application directly on host, you can follow instructions below for both Windows and Linux, or follow general instructions:
- Download and install NodeJS
- Install dependencies
npm install - Copy
example-dev.envas.envand configure variables - Copy
example.compose-dev.yamlascompose-dev.yamland configure variables - Start docker compose to start dependencies (at least mongoDB)
docker compose --file compose-dev.yaml up -d - Start server with
npm startor run debug task in VSCode
- As an alternative, you can potentially customize
docker-compose.dev.example.yamlto develop with all required tools in containers - Not tested
To allow bind on port 443, Windows users need to launch IDE as administrator.
Linux users should be able to configure non-root usage by running sudo setcap 'cap_net_bind_service=+ep' $(readlink -f $(which node))
Tested this setup 2023-10-27 with VSCode, Node.js 20 and Docker. Main app is being run directly on host, mongo, mongo express and maildev in docker compose.
- git
- nodejs lts 20
- docker desktop
- visual studio code
- Clone repo
git clone https://github.com/houby-studio/small-business-fridge.git - Launch VSCode as administrator (to be able to bind to port 443)
- Open folder small-business-fridge
- For VSCode extensions we recommend at least Prettier (Native formatter does not like handlebars)
- Install dependencies
npm install - Prepare other containers for dev
cp example.compose-dev.yaml compose-dev.yaml- If you want to run main app in container as well, there is commented out section, which may be used with some tweaks
- Prepare dotenv variables
cp example-dev.env .envand at least change following variables with your AAD registered App:- CREDS_IDENTITY_METADATA
- CREDS_CLIENT_ID
- CREDS_CLIENT_SECRET
- Start docker containers
docker compose --file compose-dev.yaml up -d - Hit F5 to start debugging
- Navigate to https://localhost/ and login with your AAD account - since you have NODE_ENV=development, all new users will be admins and suppliers by default
- Add new products, deliveries, start buying, invoicing etc.
- Navigate to http://localhost:8080 to view all e-mails being sent
- Navigate to http://localhost:8081 with login admin:pass to view, edit, export and import data in database sbf-dev
Tested this setup 2023-10-26 with VSCode, Node.js 18 and Docker. Main app is being run directly on host, mongo, mongo express and maildev in docker compose.
- git
- nodejs-lts-hydrogen
- docker
- docker-compose
- yay
- visual-studio-code-bin
- Clone repo
git clone https://github.com/houby-studio/small-business-fridge.git - Change into a directory and launch VSCode
cd small-business-fridge && code . - For VSCode extensions we recommend at least Prettier (Native formatter does not like handlebars)
- Install dependencies
npm install - Prepare other containers for dev
cp example.compose-dev.yaml compose-dev.yaml- If you want to run main app in container as well, there is commented out section, which may be used with some tweaks
- Prepare dotenv variables
cp example-dev.env .envand at least change following variables with your AAD registered App:- CREDS_IDENTITY_METADATA
- CREDS_CLIENT_ID
- CREDS_CLIENT_SECRET
- Allow node to bind to port 443
sudo setcap 'cap_net_bind_service=+ep' $(readlink -f $(which node)) - Start docker containers
docker compose --file compose-dev.yaml up -d - Hit F5 to start debugging
- Navigate to https://localhost/ and login with your AAD account - since you have NODE_ENV=development, all new users will be admins and suppliers by default
- Add new products, deliveries, start buying, invoicing etc.
- Navigate to http://localhost:8080 to view all e-mails being sent
- Navigate to http://localhost:8081 with login admin:pass to view, edit, export and import data in database sbf-dev
Copyright 2023 Jakub Šindelář
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.