Norak Pharma Documentation

cPanel Hosting Installation

For shared hosting (cPanel, Plesk, or similar) where you upload files via FTP/SFTP.

/home/username/norak-pharma/public

APP_NAME="Norak Pharma"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=username_norak
DB_USERNAME=username_dbuser
DB_PASSWORD=your_password

php artisan migrate --force
php artisan db:seed --force

Initial Setup & Configuration

After installation, follow these steps to configure your pharmacy system.

Step 1 — Login

Access the application at your domain with the default credentials:

• Email: admin@example.com
• Password: password

Step 2 — Change Admin Password

Go to Users Management → Find admin user → Edit → Change Password. Use a strong password and save immediately.

Step 3 — Configure Business Profile

Go to System Settings → Business Profile and set:

• Company name, address, phone, email
• Upload company logo
• Set currency and timezone

Step 4 — Set Up Your Store

Go to Store Outlets:

• Create your main store or edit the default one
• Set store name, address, and contact details
• Assign users to the store

Step 5 — Configure Cash Register

Go to System Settings → Register Setup:

• Create a cash register device
• Assign it to your store
• Required for cash payments in POS

Step 6 — Configure Tax Rates

Go to System Settings → Tax Config and add your local tax rates (e.g., VAT, GST). Assign rates to products as needed.

Step 7 — Set Up Receipt Template

Go to System Settings → Receipt Builder:

• Upload receipt logo and set header/footer text
• Choose paper size: 58mm or 80mm
• Configure barcode/QR code display
• Set font size, auto-print, and print copies

Step 8 — Add Products

Go to Products → Add Product:

• Enter name, SKU, barcode
• Set cost price and selling price
• Select dosage form (tablet, capsule, syrup, etc.)
• Add directions (e.g., "Take 1 tablet twice daily after meals")
• Mark as Rx (prescription required) if applicable
• Set shelf location for quick staff reference

Step 9 — Set Up Categories & Units

Go to Products → Categories to create pharmacy categories (Antibiotics, Analgesics, Vitamins, etc.). Units (tablet, capsule, ml, etc.) are pre-seeded and ready to use.

Step 10 — Configure Notifications (Optional)

Go to Message Config to set up SMS (Twilio) or WhatsApp notifications for low stock alerts, expiry warnings, and order confirmations.

System Features

Norak Pharma is a full-featured pharmacy management platform. Here's everything that's included:

Pharmacy-Specific Features

Norak Pharma includes specialized features designed exclusively for pharmacy operations — not found in generic POS systems.

💊 Prescription Management

• Rx Flag: Mark products as prescription-required
• Prescription Reference: Enter prescription ref. and doctor name at POS
• Receipt Display: Prescription info printed on patient receipt

📋 Product Directions

• Store default dispensing directions per product (e.g., "Take 1 tablet twice daily after meals")
• Directions automatically printed on receipt
• Ensures proper medication instructions for every patient

🧪 Dosage Forms

Products support all standard dosage forms:

📏 Pharmacy Units

Pre-configured units covering all common pharmacy dispensing forms:

📍 Shelf Location

• Assign shelf locations to products (e.g., "A1-3", "Cold Room", "Controlled")
• Displayed in product listings for quick retrieval
• Helps staff locate products without delay

🧾 Pharmacy Receipt Features

• Product directions printed per line item
• Prescription reference and doctor name
• Patient information
• Professional pharmacy receipt format

👤 Patient Management

• Customer records with contact details
• Full purchase history per patient
• Quick patient lookup at POS
• Walk-in customer support (auto-created on first store setup)

Hosting on Laravel Cloud

Laravel Cloud provides a fully managed platform for Laravel applications. Deploy Norak Pharma in minutes with zero server management.

FILESYSTEM_DISK=cloud
APP_ENV=production
APP_DEBUG=false

php artisan migrate --force
php artisan db:seed --force
php artisan storage:link

File Storage Configuration

Norak Pharma supports both local storage and cloud storage (S3-compatible) for product images, logos, and receipts.

Local / Public Storage (Default)

For local or small deployments:

FILESYSTEM_DISK=public

Then create the symlink:

php artisan storage:link

This links public/storage → storage/app/public, making files accessible via the web.

S3 / Cloud Storage (Recommended for Production)

For production, use S3-compatible storage (AWS S3, DigitalOcean Spaces, Laravel Object Storage):

FILESYSTEM_DISK=s3
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your-bucket-name
AWS_USE_PATH_STYLE_ENDPOINT=false

Laravel Cloud Object Storage

When using Laravel Cloud's built-in storage:

FILESYSTEM_DISK=cloud

Set the bucket to Public visibility so images are accessible. Laravel Cloud auto-injects the storage credentials when you link the bucket.

Environment Variables Reference

All configurable environment variables for Norak Pharma:

Application

Database

Storage

Notifications (Optional)

Troubleshooting

Common issues and how to resolve them.

500 Internal Server Error

• Verify .env file exists and APP_KEY is set
• Check database credentials are correct
• Ensure storage and bootstrap/cache are writable
• Temporarily set APP_DEBUG=true to see detailed errors

Images Not Displaying

• Run php artisan storage:link
• Verify public/storage symlink exists
• Check permissions on storage/app/public
• If using S3, verify bucket permissions and credentials

Route Not Found / 404 Errors

• Ensure document root points to the public folder
• Check .htaccess exists in public folder (Apache)
• Verify mod_rewrite is enabled (Apache)
• Run: php artisan config:clear && php artisan route:clear

Database Connection Error

• Verify database exists and user has proper permissions
• Check DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD in .env
• Test: php artisan tinker → DB::connection()->getPdo();

Assets Not Loading (CSS / JS)

• Run npm run build to rebuild assets
• Clear browser cache and hard reload
• Verify public/build folder exists and contains files

Migration Errors

• Ensure database exists before migrating
• Check MySQL version is 8.0+
• Verify user has CREATE TABLE permissions
• Check migration filename hasn't been renamed after initial deployment

Livewire / Alpine Not Working

• Ensure Livewire scripts are not loaded twice in layout
• Clear view cache: php artisan view:clear
• Rebuild assets: npm run build

Credits & Third-Party Libraries

Norak Pharma is built on top of these excellent open-source projects. All licenses are compatible with commercial distribution.

Core Framework

Frontend

Packages

Changelog

All notable changes to Norak Pharma are documented here.

Support & Updates

Support Policy

• Response time: Within 24–48 hours on business days
• Support includes: Bug fixes, installation help, configuration questions
• Support excludes: Custom modifications, feature development, general PHP/Laravel training

Before Opening a Ticket

• Read through this documentation fully
• Check the Troubleshooting section
• Include your PHP version (php -v)
• Include the exact error message and where it appears
• Describe the steps to reproduce the issue

Updates

• Updates are delivered via the Envato download page
• Always backup your database before applying updates
• After updating files, run: php artisan migrate --force
• Then clear cache: php artisan optimize:clear