Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

featuredrop-setup

/featuredrop-setup

Konfiguruje zestaw FeatureDrop do adopcji produktu: changelogi, plakietki funkcji, wycieczki wdrożeniowe, checklisty, hotspoty, widżety opinii i ankiety w aplikacji.

Repozytorium
featuredrop ↗
Licencja
MIT
Ostatnia zmiana repozytorium
14.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 14.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Konfiguruje zestaw FeatureDrop do adopcji produktu: changelogi, plakietki funkcji, wycieczki wdrożeniowe, checklisty, hotspoty, widżety opinii i ankiety w aplikacji.

Oryginalny opis (EN)

Configure FeatureDrop product adoption toolkit in any project. Use when adding changelogs, feature badges, onboarding tours, checklists, hotspots, feedback widgets, or surveys to an application.

Jak działa

  1. Setup Pattern
  2. Imports (ALWAYS use subpath imports)
  3. Hooks (prefer these for custom UI / shadcn projects)
  4. Components (ready-made UI)
  5. Feature Manifest Format
  6. Storage Adapters
  7. Provider Props
  8. Tailwind Integration
  9. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 118 linii, 553 słów
Podgląd SKILL.md
---
name: featuredrop-setup
description: >
  Configure FeatureDrop product adoption toolkit in any project. Use when adding
  changelogs, feature badges, onboarding tours, checklists, hotspots, feedback
  widgets, or surveys to an application.
---

# FeatureDrop — Product Adoption Toolkit

Open-source, zero-dependency library for in-app feature discovery. < 3 kB core.

## Setup Pattern

1. `npm install featuredrop`
2. Create a JSON manifest: `[{ id, label, description, releasedAt, showNewUntil? }]`
3. Wrap root: `<FeatureDropProvider manifest={features} storage={new LocalStorageAdapter()}>`
4. Add components or use headless hooks.

## Imports (ALWAYS use subpath imports)

```ts
// Core (no React, no UI)
import { isNew, getNewFeatures, createManifest, LocalStorageAdapter } from 'featuredrop'

// React components (ready-made UI)
import { NewBadge, ChangelogWidget, Tour, Checklist, Banner, Toast } from 'featuredrop/react'

// Headless hooks (data + actions, no JSX — for custom design systems / shadcn)
import { useChangelog, useNewFeature, useNewCount, useTour, useChecklist } from 'featuredrop/react/hooks'

// Storage adapters
import { PostgresAdapter, RedisAdapter, IndexedDBAdapter, HybridAdapter } from 'featuredrop/adapters'

// Validation
import { validateManifest } from 'featuredrop/schema'

// Testing helpers
import { createMockManifest, createMockStorage, TestProvider } from 'featuredrop/testing'

// Tailwind plugin
import { featureDropPlugin } from 'featuredrop/tailwind'
```

## Hooks (prefer these for custom UI / shadcn projects)

| Hook | Returns |
|------|---------|
| `useNewFeature(id)` | `{ isNew, feature, dismiss }` |
| `useNewCount()` | `number` — unread badge count |
| `useChangelog()` | `{ features, newFeatures, newCount, dismiss, dismissAll, markAllSeen, getByCategory }` |
| `useTour(id)` | `{ currentStep, stepIndex, totalSteps, isActive, start, next, prev, skip, complete, goTo }` |
| `useChecklist(id)` | `{ tasks, completedCount, totalCount, progress, isComplete, completeTask, resetTask }` |
| `useSurvey(id)` | `{ isVisible, questions, submit, askLater, dismiss }` |
| `useFeatureDrop()` | Full provider context (features, count, dismiss, throttle controls, engine) |
| `useTabNotification()` | Browser tab title: `"(3) My App"` |

## Components (ready-made UI)

NewBadge, ChangelogWidget, ChangelogPage, Tour, Checklist, Spotlight, SpotlightChain,
Hotspot, TooltipGroup, Banner, Toast, AnnouncementModal, Survey, FeedbackWidget,
FeatureRequestButton, FeatureRequestForm

## Feature Manifest Format

```ts
{
  id: string              // unique identifier
  label: string           // display title
  description: string     // what changed
  releasedAt: string      // ISO date
  showNewUntil?: string   // ISO date — auto-expire badge
  category?: string       // group: "ui", "api", "billing"
  type?: string           // "feature" | "improvement" | "fix" | "deprecation"
  priority?: string       // "low" | "medium" | "high" | "critical"
  cta?: { label: string; url: string }
  audience?: Record<string, string[]>  // user segmentation
}
```

## Storage Adapters

Default: `LocalStorageAdapter` (browser). Server: `PostgresAdapter`, `RedisAdapter`.
Offline: `IndexedDBAdapter`. Hybrid: `HybridAdapter` (local + remote sync).
Custom: implement `{ getWatermark, setWatermark, getDismissedIds, addDismissedId }`.

## Provider Props

```tsx
<FeatureDropProvider
  manifest={features}             // required
  storage={adapter}               // required
  analytics={{ onFeatureSeen, onFeatureDismissed, onFeatureClicked }}
  userContext={{ plan, role, region }}  // for audience targeting
  appVersion="2.1.0"             // semver gating
  throttle={{ maxToastsPerSession: 3, modalCooldownMs: 120_000 }}
  locale="en"                    // i18n (en/es/fr/de/pt/zh-cn/ja/ko/ar/hi)
  animation="normal"             // "none" | "subtle" | "normal" | "playful"
  engine={engineInstance}         // optional: FeatureDropEngine for smart delivery
/>
```

## Tailwind Integration

```ts
// tailwind.config.ts
import { featureDropPlugin } from 'featuredrop/tailwind'

export default {
  plugins: [featureDropPlugin({ prefix: 'fd' })],
}
// Adds: fd-badge, fd-badge-dot, fd-badge-count, fd-animate-pulse, fd-animate-fade-in
// CSS vars: --fd-new, --fd-changelog-bg, --fd-tour-bg (auto dark mode)
```

## Rules

- Always use subpath imports (`featuredrop/react`, not just `featuredrop`)
- Prefer hooks from `featuredrop/react/hooks` when the project uses shadcn, Radix, or custom design system
- Features auto-expire via `showNewUntil` — don't build manual expiry logic
- Zero production dependencies — don't add external deps
- TypeScript strict mode — no `any` types
- All components support headless mode via render props
- Core < 3 kB, React ~12 kB, fully tree-shakeable

Wersje

W bazie nie ma innych skilli o nazwie featuredrop-setup.

Migawka bazy z 13.11.2026 · wersja paczki f770c9168bf6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100product-tour-onboarding-ui-stinger
    Buduje wycieczki po aplikacji i interfejs onboardingu: narzędzia tour, podpowiedzi, checklisty, wyzwalacze segmentów i utrzymanie po zmianach UI.
  • 85atlas
    Tworzy dokumentację architektury: ADR, diagramy, changelogi, materiały wdrożeniowe i raporty o tym, co zmieniło się w projekcie.
  • 100create-code-tours
    Tworzy wycieczki po kodzie w plikach .tour dla nowych osób: opisuje domeny, zmiany w Gicie przez przyczyny i skutki oraz logikę biznesową krok po kroku.
  • 100melonhelp-feedback
    Podpina Melonhelp Feedback do aplikacji webowej i naprawia zgłoszenia użytkowników: przycisk opinii, ankiety, błędy i kolejkę zespołu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.