{"id":34915920,"url":"https://github.com/devsafix/inventory-management-system","last_synced_at":"2026-04-29T23:32:36.930Z","repository":{"id":323542336,"uuid":"1083499835","full_name":"devsafix/inventory-management-system","owner":"devsafix","description":"A comprehensive, enterprise-grade inventory management system built as a full-stack application using Next.js 15+, TypeScript, Prisma ORM, and NextAuth.js. This powerful dashboard enables businesses to efficiently track, manage, and optimize their inventory operations in real-time.","archived":false,"fork":false,"pushed_at":"2025-11-13T19:58:59.000Z","size":180,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-27T22:28:03.151Z","etag":null,"topics":["auth-stack","axios","jwt-authentication","next-auth","nextjs","posgtresql","prisma","recharts","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://inventory-m-dsx.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devsafix.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-26T06:28:09.000Z","updated_at":"2025-11-13T19:59:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devsafix/inventory-management-system","commit_stats":null,"previous_names":["devsafix/inventory-management-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devsafix/inventory-management-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsafix%2Finventory-management-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsafix%2Finventory-management-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsafix%2Finventory-management-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsafix%2Finventory-management-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devsafix","download_url":"https://codeload.github.com/devsafix/inventory-management-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsafix%2Finventory-management-system/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32448399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"ssl_error","status_checked_at":"2026-04-29T22:10:49.234Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auth-stack","axios","jwt-authentication","next-auth","nextjs","posgtresql","prisma","recharts","tailwindcss","typescript"],"created_at":"2025-12-26T12:23:06.703Z","updated_at":"2026-04-29T23:32:36.926Z","avatar_url":"https://github.com/devsafix.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# InventoryHub - Modern Inventory Management System\n\nA professional, full-featured inventory management web application built with Next.js 15, featuring real-time stock tracking, low stock alerts, and beautiful data visualizations.\n\n![Next.js](https://img.shields.io/badge/Next.js-15-black?style=flat-square\u0026logo=next.js)\n![TypeScript](https://img.shields.io/badge/TypeScript-5-blue?style=flat-square\u0026logo=typescript)\n![Tailwind CSS](https://img.shields.io/badge/Tailwind-3-38bdf8?style=flat-square\u0026logo=tailwind-css)\n![Prisma](https://img.shields.io/badge/Prisma-ORM-2D3748?style=flat-square\u0026logo=prisma)\n\n## Features\n\n### Dashboard\n\n- **Real-time Metrics**: Track total products, inventory value, and low stock items\n- **Visual Analytics**: Weekly product addition trends with interactive charts\n- **Stock Level Monitoring**: Color-coded status indicators for quick inventory assessment\n- **Distribution Overview**: Visual breakdown of in-stock, low-stock, and out-of-stock items\n\n### Inventory Management\n\n- **Product CRUD Operations**: Add, view, update, and delete products\n- **Low Stock Alerts**: Customizable threshold notifications\n- **SKU Tracking**: Unique product identification\n- **Price \u0026 Quantity Management**: Real-time inventory valuation\n\n### Modern UI/UX\n\n- **Responsive Design**: Seamless experience across all devices\n- **Dark Theme Sidebar**: Professional slate-900 color scheme\n- **Smooth Animations**: Framer Motion powered interactions\n- **Accessible Components**: Built with shadcn/ui components\n\n### Authentication\n\n- **Secure Auth**: Powered by Stack Auth\n- **User Management**: Built-in user profiles and sessions\n- **Protected Routes**: Automatic authentication checks\n\n## Tech Stack\n\n### Frontend\n\n- **[Next.js 15](https://nextjs.org/)** - React framework with App Router\n- **[TypeScript](https://www.typescriptlang.org/)** - Type-safe development\n- **[Tailwind CSS](https://tailwindcss.com/)** - Utility-first styling\n- **[shadcn/ui](https://ui.shadcn.com/)** - Beautiful UI components\n- **[Framer Motion](https://www.framer.com/motion/)** - Smooth animations\n- **[Recharts](https://recharts.org/)** - Data visualization\n- **[Lucide React](https://lucide.dev/)** - Modern icon library\n\n### Backend \u0026 Database\n\n- **[Prisma](https://www.prisma.io/)** - Next-generation ORM\n- **[PostgreSQL](https://www.postgresql.org/)** - Reliable database (or your DB)\n- **[Stack Auth](https://stack-auth.com/)** - Authentication solution\n\n## Prerequisites\n\nBefore you begin, ensure you have the following installed:\n\n- **Node.js** (v18 or higher)\n- **npm** or **pnpm** or **yarn**\n- **PostgreSQL** (or your preferred database)\n- **Git**\n\n## Installation\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/devsafix/inventory-management-system\n   cd inventory-management-system\n   ```\n\n2. **Install dependencies**\n\n   ```bash\n   npm install\n   # or\n   pnpm install\n   # or\n   yarn install\n   ```\n\n3. **Set up environment variables**\n\n   Create a `.env` file in the root directory:\n\n   ```env\n   # Database\n   DATABASE_URL=\"postgresql://user:password@localhost:5432/inventory_db\"\n\n   # Stack Auth\n   NEXT_PUBLIC_STACK_PROJECT_ID=\"your_stack_project_id\"\n   NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY=\"your_publishable_key\"\n   STACK_SECRET_SERVER_KEY=\"your_secret_key\"\n\n   # App URL\n   NEXT_PUBLIC_APP_URL=\"http://localhost:3000\"\n   ```\n\n4. **Set up the database**\n\n   ```bash\n   # Generate Prisma Client\n   npx prisma generate\n\n   # Run migrations\n   npx prisma migrate dev\n\n   # (Optional) Seed database\n   npx prisma db seed\n   ```\n\n5. **Run the development server**\n\n   ```bash\n   npm run dev\n   # or\n   pnpm dev\n   # or\n   yarn dev\n   ```\n\n6. **Open your browser**\n\n   Navigate to [http://localhost:3000](http://localhost:3000)\n\n## Project Structure\n\n```\ninventory-management/\n├── app/                      # Next.js app directory\n│   ├── (auth)/              # Authentication routes\n│   ├── dashboard/           # Dashboard page\n│   ├── inventory/           # Inventory management\n│   ├── add-product/         # Add product form\n│   ├── settings/            # Settings page\n│   └── layout.tsx           # Root layout\n├── components/              # React components\n│   ├── Sidebar.tsx          # Navigation sidebar\n│   ├── ProductsChart.tsx    # Chart component\n│   └── ui/                  # shadcn/ui components\n├── lib/                     # Utility functions\n│   ├── actions/             # Server actions\n│   ├── auth.ts              # Auth helpers\n│   └── prisma.ts            # Prisma client\n├── prisma/                  # Database schema\n│   └── schema.prisma        # Prisma schema\n├── public/                  # Static assets\n└── package.json             # Dependencies\n```\n\n## Configuration\n\n### Database Schema\n\nThe main `Product` model includes:\n\n- `id` - Unique identifier\n- `name` - Product name\n- `quantity` - Stock quantity\n- `price` - Product price\n- `sku` - Stock Keeping Unit (optional)\n- `lowStockAt` - Low stock threshold\n- `userId` - Owner reference\n- `createdAt` - Creation timestamp\n- `updatedAt` - Last update timestamp\n\n### Customizing the Theme\n\nModify `tailwind.config.ts` to customize colors and styling:\n\n```typescript\ntheme: {\n  extend: {\n    colors: {\n      // Add your custom colors\n    },\n  },\n}\n```\n\n## Features Breakdown\n\n### Dashboard Analytics\n\n- **Key Metrics Card**: Displays total products, inventory value, and low stock alerts\n- **Weekly Trends Chart**: Visual representation of product additions over 12 weeks\n- **Stock Levels List**: Recent products with color-coded status indicators\n- **Distribution Chart**: Circular chart showing stock distribution percentages\n\n### Product Management\n\n- **Add Products**: Form with validation for name, quantity, price, SKU, and low stock threshold\n- **View Inventory**: Searchable, sortable table of all products\n- **Update Products**: Inline editing capabilities\n- **Delete Products**: Confirmation dialog before deletion\n\n### Responsive Design\n\n- **Mobile**: Slide-in navigation menu with backdrop overlay\n- **Tablet**: Optimized grid layouts\n- **Desktop**: Full sidebar with all features visible\n\n## Deployment\n\n### Deploy on Vercel\n\n1. Push your code to GitHub\n2. Import project on [Vercel](https://vercel.com)\n3. Add environment variables\n4. Deploy!\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new)\n\n### Deploy on Other Platforms\n\nThe app can be deployed on any platform that supports Next.js:\n\n- **Netlify**\n- **Railway**\n- **Render**\n- **AWS Amplify**\n- **DigitalOcean App Platform**\n\n## Scripts\n\n```bash\nnpm run dev          # Start development server\nnpm run build        # Build for production\nnpm run start        # Start production server\nnpm run lint         # Run ESLint\nnpm run type-check   # Run TypeScript compiler check\n```\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eMade with ❤️ using Next.js and TypeScript\u003c/p\u003e\n  \u003cp\u003e⭐ Star this repo if you find it helpful!\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevsafix%2Finventory-management-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevsafix%2Finventory-management-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevsafix%2Finventory-management-system/lists"}