open-index/open-npm huggingface dataset:
npm package: @shakibdshy/tailwind-theme
Description: A Tailwind CSS plugin providing theme utilities and color system
Author: Md Habibur Rahman
Latest version: 1.0.15

# @shakibdshy/tailwind-theme

A Tailwind CSS plugin that provides a comprehensive theme system with predefined color palettes and utilities.

## Installation

```bash
npm install @shakibdshy/tailwind-theme
# or
yarn add @shakibdshy/tailwind-theme
# or
pnpm add @shakibdshy/tailwind-theme
```

## Usage

Add the plugin to your `tailwind.config.js`:

```js
module.exports = {
  content: [
    "./src/**/*.{js,ts,jsx,tsx}",
    "./node_modules/@shakibdshy/tailwind-theme/dist/**/*.{js,ts,jsx,tsx,mdx}",
  ],
  plugins: [
    require('@shakibdshy/tailwind-theme')
  ],
}
```

This will add the following features to your Tailwind setup:

- Predefined color palettes (primary, secondary, neutral, success, error, warning, info)
- Dark mode support
- Extended typography scales
- Custom shadow utilities

## Color System

The plugin includes a comprehensive color system with the following palettes:

- Primary: Teal-based palette
- Secondary: Lime-based palette
- Neutral: Cool gray palette
- Success: Green palette
- Error: Red palette
- Warning: Orange palette
- Info: Blue palette

Each color has variants from 50 to 950.

## Dark Mode Support

The plugin includes built-in dark mode support. Enable it by adding the `data-theme="dark"` attribute to your HTML element.

## License

MIT
npm package: @shakil_nee/create-mvp-kit
Description: Scaffold a full-stack MVP with FastAPI, Next.js, Railway, and Vercel in minutes
Author: Shakil
Latest version: 1.0.3

# create-mvpkit

Scaffold a production-ready MVP with FastAPI + Next.js + Railway + Vercel in under 2 minutes.

## What You Get

```
my-app/
├── backend/           # FastAPI
│   ├── api.py         # Endpoints
│   ├── db.py          # SQLite helpers
│   └── ...
├── frontend/          # Next.js + Tailwind
│   ├── app/
│   └── ...
└── .github/
    └── workflows/
        └── deploy.yml # Auto-deploy on push
```

Plus:
- Private GitHub repo created
- Backend deployed to Railway
- Frontend deployed to Vercel
- GitHub Actions configured
- Environment variables set
- CORS configured

## Usage

```bash
npx create-mvpkit my-app
```

## Requirements

Before running, you'll need:

1. **GitHub Personal Access Token**
   - Go to github.com/settings/tokens
   - Generate new token (classic)
   - Scopes: `repo`, `workflow`

2. **Railway Token**
   - Go to railway.app/account/tokens
   - Create token

3. **Vercel Token**
   - Go to vercel.com/account/tokens
   - Create token

## Options

```bash
# Just generate code, skip deployment
npx create-mvpkit my-app --skip-deploy

# Skip GitHub repo creation
npx create-mvpkit my-app --skip-github
```

## Local Development

After creating your project:

```bash
cd my-app

# Install frontend dependencies
npm run install:all

# Install backend dependencies
pip install -r backend/requirements.txt

# Start frontend (localhost:3000)
npm run dev

# Start backend (localhost:8000) 
npm run dev:api
```

## Deployment

Automatic on push to `main` branch.

Or deploy manually:

```bash
# Backend
cd backend
railway up

# Frontend
cd frontend
vercel --prod
```

## License

MIT
npm package: @shakilhossainp/ezylogger
Description: A brief description of your package and what it does.
Author: shakil
Latest version: 1.0.1

# ezylogger

A brief description of your package and what it does.

## Installation

To install the package, use npm:

```sh
npm install ezylogger

Usage
Here's an example of how to use the package:

js
Copy code
const ezylogger = require('ezylogger');

// Example usage
ezylogger.log('Hello, world!');
API
ezylogger.log(message)
Logs a message to the console.

Parameters:

message (string): The message to log.
Contributing
If you want to contribute to this project, please follow these steps:

Fork the repository.
Create a new branch for your changes.
Submit a pull request with a clear description of your changes.
npm package: @shaking-crab/payroll-math
Description: Pure TypeScript payroll calculators for FE & BE
Latest version: 0.5.23

# @shaking-crab/payroll-math

A lightweight, **TypeScript-based payroll calculation library** designed for restaurant and hospitality use cases.  
It provides a set of pure utility functions to calculate **wages, tips, overtime, and compliance adjustments** with clear and predictable logic.  
All functions are side-effect free and can be used both in frontend and backend environments.

## 🚀 Features

- **Pure TypeScript** with no runtime dependencies  
- **Role-based tip allocation** (Server, Busser, Bartender, etc.)  
- **Weekly overtime calculation** following standard 40-hour rules  
- **Spread of Hours** computation for states like New York  
- **Minimum wage adjustment** and compliance support  
- **Accurate rounding logic** aligned with UI rounding behavior  
- Fully tested with [Vitest](https://vitest.dev)

## 📦 Installation

```bash
npm install @shaking-crab/payroll-math
# or
yarn add @shaking-crab/payroll-math
```

## 🧮 Quick Start

```ts
import {
  calculatePeriodTotals,
  calculateEmployee,
  sumPayrollTotals,
  computeWeeklyOvertime,
  computeSpreadOfHours,
  applyMinimumPayAdjustment,
} from '@shaking-crab/payroll-math';

const period = calculatePeriodTotals({
  sales: 1000,
  ccTips: 500,
  sc: 100,
});
console.log(period); // { totalTips: 600, tipsPercent: 0.6 }

const overtime = computeWeeklyOvertime([
  { date: '2025-10-06', hour: 42, payRate: 15, payType: 1, position: 1 },
]);
console.log(overtime.overtimeHours); // 2
```

## 🧩 API Overview

### `calculatePeriodTotals(input)`
Calculates total credit-card tips + service charges for a single payroll period.

| Parameter | Type | Description |
|------------|------|--------------|
| `sales` | `number` | Total sales for the period |
| `ccTips` | `number` | Credit card tips |
| `sc` | `number` | Service charge |

Returns `{ totalTips, tipsPercent }`.

### `calculateEmployee(input)`
Computes tips and total pay for an individual employee, considering role type, percentage, and other roles’ shares.

### `sumPayrollTotals(periods)`
Aggregates total credit and cash tips from multiple periods with rounding.

### `computeWeeklyOvertime(records)`
Splits hours into **regular** and **overtime** portions across multiple days (40-hour threshold).  
Handles **hourly (payType=1)** and **salary (payType=2)** workers.

### `computeSpreadOfHours(input)`
Implements New York's “Spread of Hours” rule.  
Adds 1 hour of pay for each workday longer than a threshold (default: 10h).

### `applyMinimumPayAdjustment(input)`
Ensures pay meets minimum wage by adjusting cash tips or bonus pay as needed.

## 🧪 Testing

```bash
npm run test
# or
yarn test
```

## 🧱 Project Structure

```
src/
├── calcEmployee.ts
├── calcPayroll.ts
├── calcPeriod.ts
├── minimumPay.ts
├── overtime.ts
├── spread.ts
├── math.ts
└── types.ts
```

## 🧾 License

MIT © Shaking Crab LLC
npm package: @shaking-crab/weekly-check-math
Description: Pure weekly check calculation for Shaking Crab
Author: Yihui Liu
Latest version: 0.3.2

# @shaking-crab/weekly-check-math 🧮

统一计算门店每周营运数据的数学工具包。
用于将 Homebase / Clover / Vendor 采购数据整合为一致、可复用的指标结构（Revenue、Labor、Discounts、Inventory、Online Sales 等），并生成 **门店行 + Summary Total + Summary Average**。

这是 Shaking Crab 管理系统中周检查（Weekly Check）页面的核心计算逻辑。

## ✨ 功能特性

- 统一的 **Raw → Metrics** 数据管线  
- 自动计算：Labor%、Discount%、Inventory%、Online%、Adjusted Sales  
- 自动汇总 total + average  
- 完整 TypeScript 类型支持  
- 高精度百分比计算  
- 浏览器 + Node 通用（ESM/CJS）

## 📦 安装

```bash
npm install @shaking-crab/weekly-check-math
```

## 🚀 示例

```ts
import {
  summarizeInventoryForLocation,
  computeLocationWeeklyMetrics,
  summarizeWeeklyChecking,
} from '@shaking-crab/weekly-check-math';

const raw = { /* ... */ };
const purchases = [ /* ... */ ];

const inventory = summarizeInventoryForLocation(purchases);
const metrics = computeLocationWeeklyMetrics(raw, inventory);
const summary = summarizeWeeklyChecking([metrics]);

console.log(summary);
```

## 🧪 测试

```bash
npm test
```

包含 utils、inventory、metrics、E2E 全套测试。

## 🔄 发布

```bash
npm run release
```

自动构建 + 打 tag + push + GitHub Actions + npm publish。

需要在 Secrets 设置：

```
NPM_TOKEN
```