Ahmad-Alkaf/CornerTill
Ahmad-Alkaf/CornerTill has 39 GitHub stars and 9 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:03 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Laravel React application for simple Point of Sale (POS) app
Web & AppsREADME.md
OriginalCornerTill
CornerTill (Arabic: كورنر تِل) is a simple point of sale (POS) web app for small shops: inventory, checkout, bills, and a dashboard. Formerly named Laptop POS. Website: https://cornertill.com (a KafLabs product).
The screenshots use the demo data of database/seeders/ScreenshotDemoSeeder.php.
Main Pages
Inventory Page

Checkout Page

Dashboard Page

Workflow
- All commits should be pushed to the
devbranch. - When the
devbranch becomes stable it will be merged to thestagingbranch. - So that the
stagingbranch can be deployed and viewed by the client. - After that, if the client approves the staging, then it will be merged to
production. - The
productionbranch is the production environment on the server.
Development Environment
Clone the repo to your local computer:
git clone https://github.com/Ahmad-Alkaf/CornerTill
Navigate to the cloned project folder:
cd CornerTill
Install the dependencies:
composer install
copy .env.example file and rename the copy to .env. This file is not in the repo because it is sensitive:
cp .env.example .env
Configure the database information in the .env file (DB_*).
DB_DATABASE=yourdatabase_name
DB_USERNAME=your_username
DB_PASSWORD=your_password
Sets the APP_KEY value in your .env file:
php artisan key:generate
Create the database/migrations schema:
php artisan migrate
//OR to drop all existing tables
php artisan migrate:fresh
Seed the database with fake data.
Note: there will be a user with email of [email protected] and password of asdfasdf, you can login directly with it.
php artisan db:seed
Generate a link folder (shortcut) on the public directory to serve the client with files that located on a private directory.
php artisan storage:link
Install all dependencies:
npm install
Run Vite, to hot module reloading (HMR):
npm run dev
In a separate terminal run the Laravel app:
php artisan serve
Powered by
- Laravel as a backend.
- Inertia as a glow between the backend and frontend.
- React as a frontend (Typescript).
- Tailwind as a salt and black pepper for React.
- Breeze to create a starting scaffold of the above (Welcome, Login, Register, ...etc) pages.
- React Icons to use icons from different libraries in React.
Launch switches
config/features.php reads these variables. They hide features; they do not remove code.
| Variable | Default | Effect |
|---|---|---|
PAYMENTS_ENABLED |
false |
false: free beta. Paddle plans, pricing, subscription routes, the Paddle webhook, and Paddle.js are off (routes return 404). The pages show "Free during beta". Every business uses the beta limits. true: the Paddle subscription flow works as before (see the warning below). |
BETA_MAX_ACCOUNTS, BETA_MAX_PRODUCTS, BETA_MAX_BILLS_PER_MONTH |
2, 500, 15000 |
Beta limits for each business (same as the Basic plan). |
SOCIAL_GOOGLE_ENABLED |
true |
Google login button and /auth/google/* routes. |
SOCIAL_GITHUB_ENABLED |
true |
GitHub login button and /auth/github/* routes. |
SOCIAL_X_ENABLED |
false |
X login button and /auth/x/* routes. |
A disabled provider hides its button, and its routes return 404.
Before you set PAYMENTS_ENABLED=true: name the payment provider in Privacy section 7 (resources/js/Pages/Anyone/PrivacyPolicy.tsx), update Terms section 7 (resources/js/Pages/Anyone/TermsAndConditions.tsx), publish a refund policy and link it from the pricing cards, and change LEGAL_LAST_UPDATED (resources/js/Utilities/Constant.ts). The legal pages now say that CornerTill takes no payments and has no paid plans, and the flag does not change them.
Language
The app detects the browser language. Arabic browsers get Arabic; all other browsers get English (the default). The EN/AR switch in the guest header and the app header changes the language. The selected language is kept in localStorage (i18nextLng) and a cookie (i18next). Arabic uses a full right-to-left layout: <html dir="rtl">. Use logical Tailwind classes (ms-, me-, ps-, pe-, start-, end-, text-start, rounded-s-, ...) and rtl:space-x-reverse, not ml-/mr-/left-/right-. Exception: classes on Material Tailwind components go through its tailwind-merge 1.8, which does not know logical classes; there use physical classes with ltr:/rtl: variants. Wrap user text (names, descriptions) in <bdi>.
Server messages (validation, flash, error pages) follow the same language: the SetLocale middleware reads the i18next cookie, then Accept-Language. Arabic texts are in lang/ar/*.php and lang/ar.json. Translations are in public/locales/<lang>/translation.json.
Deploy on Coolify
Domain: https://cornertill.com (apex) is the canonical host. Add www.cornertill.com too and redirect it to the apex with HTTP 301.
Build pack: Dockerfile (the repository Dockerfile). The image builds the Composer and Vite assets. No build-time variable is necessary.
- Port:
8080. - Health check:
GET /api/health. It returns HTTP 200{"status":"ok","database":"ok"}when Laravel runs and MySQL answers, and HTTP 503 when MySQL fails. The route has no session and no auth. The database check waits at most about 2 ×DB_HEALTH_TIMEOUT(default 2 seconds); when the MySQL host name does not resolve, the DNS lookup can add about 10 seconds. In Coolify, set the health check path to/api/healthand the port to8080. - Start: the container caches config, routes, views, and events, then runs
php artisan migrate --force(it tries again for about 60 seconds while MySQL starts). SetRUN_MIGRATIONS=falseto skip it. Then it runsphp artisan bills:fill-sale-values: bills that an older version wrote (also the old container during a rolling deploy) get their stored tax rate, currency, and prices. The scheduler repeats it every hour. It is safe to run any number of times. - Persistent storage: add a Coolify volume mount at
/var/www/html/storage. It holds the uploads (storage/app/public/products-imagesandstorage/app/public/businesses-logo), sessions, and the framework cache. The image already linkspublic/products-imagesandpublic/businesses-logoto these folders (the same result asphp artisan storage:link). Use a volume, not a root-owned bind mount: the app runs aswww-data. For S3-compatible storage, setFILESYSTEM_DISK=s3and theAWS_*values instead. - Deleted businesses: "Delete business" is a soft delete. Support can restore a business with
php artisan business:restore <id>(see--help). Every day,php artisan business:purge-deletedpermanently deletes all data of each business that was deleted more than 30 days before (config/constants.php). This also applies to businesses that an older version deleted. Before the first deploy of this feature on a database that has older deleted businesses, runphp artisan business:purge-deleted --dry-runto see what the first daily run will delete. - Queue worker and scheduler: with the default
CONTAINER_ROLE=all, supervisord runs nginx, PHP-FPM,php artisan queue:work, andphp artisan schedule:work(it runsschedule:runevery minute) in the same container. To run them as separate Coolify services, use the same image withCONTAINER_ROLE=webfor the app,CONTAINER_ROLE=worker, andCONTAINER_ROLE=scheduler.
Required environment variables:
| Variable | Value |
|---|---|
APP_KEY |
Output of php artisan key:generate --show. The container does not start without it. |
APP_URL |
https://cornertill.com |
APP_ENV, APP_DEBUG |
production, false (image defaults) |
DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
The dedicated MySQL database |
QUEUE_CONNECTION |
database (image default; the jobs table comes from the migrations) |
FILESYSTEM_DISK |
local (image default; uploads on the volume) or s3. Do not leave it empty: config/filesystems.php then selects the S3 disks. |
MAIL_MAILER, MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_ENCRYPTION |
SMTP account |
MAIL_FROM_ADDRESS, MAIL_FROM_NAME |
[email protected], CornerTill |
ADMIN_REPORT_EMAIL |
Receiver of the daily database table counts email (scheduled task). Empty: no email; the counts go only to the log. |
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET |
OAuth apps, or turn the provider off with its SOCIAL_*_ENABLED switch |
PAYMENTS_ENABLED |
false for the free beta (read the warning in "Launch switches" before true) |
Logs go to the container output (LOG_CHANNEL=stderr).
Local test of the image:
docker build -t cornertill .
docker run --rm -p 8080:8080 -e APP_KEY=base64:... -e DB_HOST=... -e DB_DATABASE=... \
-e DB_USERNAME=... -e DB_PASSWORD=... -v cornertill-storage:/var/www/html/storage cornertill
curl -i http://localhost:8080/api/health
License
The source is public under PolyForm Noncommercial 1.0.0. See the license for permitted uses and conditions.