Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/JReyna217/PharmaVault/llms.txt

Use this file to discover all available pages before exploring further.

PharmaVault is a full-stack web application that helps individuals and families manage their pharmaceutical inventory. Built with ASP.NET Core Blazor (Interactive Server) and PostgreSQL, it provides a secure, real-time dashboard to monitor medication stock levels, track expiration dates, and maintain a master catalog of drugs — so you never run out of a critical medicine or keep expired stock on hand.

Quickstart

Get PharmaVault running locally in minutes — database setup, secrets config, and first run.

Deployment

Deploy to Ubuntu with Docker and Nginx for a production-ready, HTTPS-enabled setup.

Core Features

Explore the dashboard, inventory management, medicine catalog, and authentication system.

Architecture

Understand the Clean Architecture / N-Tier design and how the three projects interact.

What PharmaVault Does

PharmaVault solves a common household problem: managing personal or family medical supplies often leads to expired medications, unnecessary duplicate purchases, and lost track of prescriptions. PharmaVault centralizes all of this into a single, secure web interface.

Inventory Tracking

Add, edit, and delete medication stock linked to your user account. Each item tracks quantity, purchase date, expiration date, and prescription notes.

Expiration Alerts

The dashboard automatically categorizes stock into Good Condition, Expiring Soon (within 30 days), and Expired — with visual color coding.

Medicine Catalog

Maintain a master catalog of drugs with their pharmaceutical form (tablet, capsule, syrup) and dosage. All inventory items link back to the catalog.

Getting Started

1

Set up PostgreSQL

Install PostgreSQL locally or via Docker, then run the two SQL initialization scripts to create the database and schema.
2

Configure your connection string

Use .NET User Secrets to store your PostgreSQL credentials securely without committing them to source control.
3

Run the application

Build and launch the Blazor app with dotnet run or dotnet watch for hot reload during development.
4

Register and log in

Create your user account through the registration page. Your password is hashed with BCrypt before storage.
PharmaVault is licensed under the Apache-2.0 license. See the LICENSE file for details.

Build docs developers (and LLMs) love