NHS Equipment Sharing Platform

A web application that connects hospitals and medical societies to efficiently redistribute expired or surplus medical equipment.

Tech Stack

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS + DaisyUI
• Database: PostgreSQL with Drizzle ORM
• Authentication: NextAuth.js

Features

• Hospital and Medical Society user roles
• Equipment listing management for hospitals
• Equipment browsing and search for medical societies
• Request and approval workflow
• Transfer tracking and history
• Real-time notifications

Getting Started

Prerequisites

• Node.js 18+
• PostgreSQL database
• npm or yarn

Installation

1. Clone the repository:

cd NHS_NEED

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env

Edit .env and add your database connection string and other required variables.

4. Generate and run database migrations:

npm run db:generate
npm run db:push

5. Start the development server:

npm run dev

6. Open http://localhost:3000 in your browser.

Database Management

• npm run db:generate - Generate migration files from schema
• npm run db:push - Push schema changes to database
• npm run db:studio - Open Drizzle Studio (database GUI)

Project Structure

NHS_NEED/
├── src/
│   ├── app/              # Next.js app directory (routes)
│   ├── components/       # React components
│   ├── db/              # Database schema and config
│   ├── lib/             # Utility functions
│   └── types/           # TypeScript type definitions
├── public/              # Static files
├── drizzle/            # Database migrations
├── .env                # Environment variables
└── package.json        # Dependencies

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Run ESLint

Contributing

1. Create a feature branch
2. Make your changes
3. Submit a pull request

License

MIT