PDS SDK

@puninar-logistics/pds-sdk

SDK internal yang berisi shared components, hooks, utilities, dan design system yang digunakan lintas project frontend di lingkungan PDS.

🎯 Tujuan

• Menyediakan komponen UI yang konsisten lintas project
• Mengurangi duplikasi kode
• Menjadi single source of truth untuk design system dan shared logic

📦 Tech Stack

| Teknologi | Deskripsi | |----------|-----------| | React 19 | Library UI | | TypeScript | Static typing | | Vite | Dev & testing | | Tsup | Build SDK | | shadcn/ui | UI system | | Tailwind CSS | Styling |

📁 Struktur Folder

src/
├─ api/
├─ assets/
├─ auth/
├─ components/
│  ├─ animation/
│  ├─ core/          # custom components internal
│  ├─ error-pages/
│  ├─ form/
│  ├─ ui/            # shadcn components
│  └─ other/
├─ hoc/
├─ hooks/
├─ lib/
├─ types/
├─ utils/            # helper & formatter functions
├─ global.css
├─ custom.css
├─ App.tsx
├─ main.tsx
└─ index.ts

🛠 Scripts

| Command | Fungsi | |--------|---------| | npm run dev | Jalankan Vite untuk test SDK | | npm run watch | Watch & rebuild SDK dengan Tsup | | npm run build-tsup | Build SDK production | | npm run lint | Lint |

🔗 Local Development Setup

1. Install & Link SDK

cd pds-sdk
npm install
npm link

2. Jalankan Watch Mode

npm run watch

3. Gunakan SDK di Project Lain

npm uninstall @puninar-logistics/pds-sdk
npm link @puninar-logistics/pds-sdk

⚙️ Troubleshooting

SDK tidak ter-update di project

• Pastikan npm run watch berjalan
• Pastikan tidak ada error build
• Relink jika perlu:

npm unlink @puninar-logistics/pds-sdk
npm link @puninar-logistics/pds-sdk

🧪 Development Notes

• Gunakan export dari src/index.ts sebagai public API
• Hindari import internal path langsung (src/components/...)
• Selalu bump version jika ada breaking changes

📄 License

Internal — PT Puninar Logistics.

👨‍💻 Maintainer

Frontend Team — PDS