Getting Started

Get up and running with MediFlux in minutes.

1 min read

This guide walks you through the initial setup of MediFlux so you can start managing your pharmacy operations as quickly as possible. By the end of this guide, you'll have a running MediFlux instance with a configured pharmacy profile ready to process transactions.

Before you begin, make sure you've completed the installation process and have MediFlux running on your machine or server.

Quick Start

Create Your Organization

After launching MediFlux for the first time, you'll be prompted to create your organization. This is the top-level entity that contains all your pharmacy locations, users, and settings.

Example: Create Organization via API

const response = await fetch("https://api.mediflux.io/v1/organizations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer your-api-key",
  },
  body: JSON.stringify({
    name: "HealthFirst Pharmacies",
    type: "pharmacy_chain",
    country: "US",
    timezone: "America/New_York",
  }),
});

const organization = await response.json();
console.log("Organization created:", organization.id);

You can also complete this step through the MediFlux web dashboard at http://localhost:3000/setup.

Configure Your First Pharmacy Location

Each pharmacy location operates as an independent unit within your organization, with its own inventory, staff, and settings. Add your first location to start managing day-to-day operations.

Example: Add a Pharmacy Location

const location = await fetch("https://api.mediflux.io/v1/locations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer your-api-key",
  },
  body: JSON.stringify({
    organization_id: "org_abc123",
    name: "Downtown Pharmacy",
    address: {
      street: "123 Main Street",
      city: "Springfield",
      state: "IL",
      zip: "62701",
    },
    license_number: "PH-2024-001234",
    phone: "+1-555-0123",
  }),
});

Set Up User Accounts

Create user accounts for your pharmacy staff. MediFlux supports role-based access control with predefined roles like pharmacist, technician, cashier, and manager, or you can define custom roles.

Example: Create a Staff User

const user = await fetch("https://api.mediflux.io/v1/users", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer your-api-key",
  },
  body: JSON.stringify({
    email: "jane.doe@healthfirst.com",
    name: "Jane Doe",
    role: "pharmacist",
    location_id: "loc_xyz789",
    permissions: ["sales.create", "inventory.view", "prescriptions.manage"],
  }),
});

Always follow the principle of least privilege when assigning permissions. Grant users only the access they need for their specific role.

Import Your Inventory

Load your existing product catalog and inventory into MediFlux. You can import data from CSV files, connect to supplier catalogs, or enter products manually.

Import inventory from CSV

mediflux import inventory \
  --file ./inventory-export.csv \
  --location loc_xyz789 \
  --format csv \
  --mapping name:product_name,sku:item_code,qty:stock_quantity

MediFlux automatically validates imported data and flags any issues like duplicate SKUs, missing required fields, or invalid batch numbers before committing changes.

Start Processing Sales

With your organization, location, users, and inventory configured, you're ready to process your first sale. Head to the Sales section to learn about the point-of-sale workflow.

Media Examples

Use hosted image URLs in standard Markdown — the alt text becomes the visible title below the image:

Or use the Figure component when you need a separate title and description:

Pharmacy inventory workflow
Hosted on Picsum — inventory counts synced across locations.

Embed a YouTube walkthrough with the video ID or full URL:

MediFlux platform overview

YouTube walkthrough of the MediFlux dashboard.

Embed a hosted video file from an external URL:

Hosted training video sample

Hosted MP4 from an external storage URL.

Environment Configuration

MediFlux uses environment variables for core configuration. Here's a minimal configuration to get started:

.env

# Database
DATABASE_URL=postgresql://mediflux:password@localhost:5432/mediflux

# Application
MEDIFLUX_PORT=3000
MEDIFLUX_SECRET_KEY=your-secret-key-here
MEDIFLUX_ENV=production

# Storage
MEDIFLUX_STORAGE_TYPE=local
MEDIFLUX_STORAGE_PATH=/var/mediflux/uploads

For a complete list of configuration options, see the Configuration guide.

Next Steps

Now that you have MediFlux up and running, explore the platform's core modules:

Installation

Install and configure MediFlux for your environment.

Purchase Orders

Set up supplier relationships and manage inventory procurement.

Accounting

Configure your chart of accounts and start tracking finances.

API Reference

Integrate MediFlux with your existing systems using our comprehensive API.

Download Mobile Application

Download the official MediFlux application from the Play Store.

Introduction

Installation