Index of every page on this site: llms.txt
All skills
onmax avatar

/nuxt-protokit

@b4e1a3f official
by Maxonmax/nuxt-skills729 stars
38
Run it yourself

Use when building schema-driven prototypes with nuxt-protokit (@websideproject/nuxt-protokit) - provides definePrototype, usePrototype, ProtoTool, collections, derived values, and visualizations for rapid SaaS tool prototyping.

Use this Skill: https://skilld.dev/gh/onmax/nuxt-skills/nuxt-protokit

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesvisualizations.md

≈1.4k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Visualizations Reference

Add visualizations to schema.visualizations: VizDef[]. Each item references a zero-based index in layout.

visualizations: [
  { type: 'bar-chart', config: { ... } },       // index 0
  { type: 'stat-cards', config: { ... } },      // index 1
],
layout: {
  rows: [{ cols: 2, items: [
    { type: 'viz', vizIndex: 0 },
    { type: 'viz', vizIndex: 1 },
  ]}]
}

All config callbacks receive ctx: ComputeContext ({ fields, derived, connections, collections }).


Built-In Viz Types

progress — Progress Bar

{
  type: 'progress',
  title?: 'Runway',
  config: {
    type: 'progress',
    value: ctx => ctx.derived.runwayMonths,
    max?: 24,
    label?: ctx => `${ctx.derived.runwayMonths} months`,
    thresholds?: [
      { value: 6,  color: 'error',   label: 'Critical' },
      { value: 12, color: 'warning', label: 'Low' },
      { value: 24, color: 'success', label: 'Healthy' },
    ],
  },
}

benchmark — Benchmark Bar

Positions a value against a median reference with min/max range.

{
  type: 'benchmark',
  config: {
    type: 'benchmark',
    value: ctx => ctx.fields.cac,
    median: 150,
    min?: 50,
    max?: 500,
    label?: 'CAC vs Industry',
    unit?: '$',
  },
}

bar-chart

{
  type: 'bar-chart',
  config: {
    type: 'bar-chart',
    data: ctx => [
      { label: 'Jan', value: ctx.fields.jan, color?: '#3B82F6' },
      { label: 'Feb', value: ctx.fields.feb },
    ],
    maxValue?: number,
    unit?: '$',
  },
}

line-chart

{
  type: 'line-chart',
  config: {
    type: 'line-chart',
    data: ctx => ctx.collections.metrics.map(m => ({ label: m.month, value: m.mrr })),
    color?: '#3B82F6',
    showAxes?: true,
    unit?: '$',
    emptyText?: 'No data yet',
  },
}

area-chart — Multi-Series

{
  type: 'area-chart',
  config: {
    type: 'area-chart',
    series: ctx => [
      { label: 'Revenue', color: '#10B981',
        data: ctx.collections.months.map(m => ({ label: m.name, value: m.revenue })) },
      { label: 'Costs', color: '#F43F5E',
        data: ctx.collections.months.map(m => ({ label: m.name, value: m.costs })) },
    ],
    showAxes?: true,
    unit?: '$',
  },
}

pie-chart / donut-chart

{
  type: 'pie-chart',   // or 'donut-chart'
  config: {
    type: 'pie-chart',
    data: ctx => ctx.collections.channels.map(c => ({ label: c.name, value: c.revenue })),
    unit?: '$',
    showLegend?: true,
    emptyText?: 'No channels yet',
  },
}

funnel-chart

{
  type: 'funnel-chart',
  config: {
    type: 'funnel-chart',
    data: ctx => [
      { label: 'Visitors',  value: ctx.fields.visitors },
      { label: 'Signups',   value: ctx.fields.signups },
      { label: 'Paid',      value: ctx.fields.paid },
    ],
    unit?: '',
    showConversion?: true,   // show conversion % between stages
  },
}

stat-cards

{
  type: 'stat-cards',
  config: {
    type: 'stat-cards',
    cols?: 3,   // 1 | 2 | 3 | 4
    cards: ctx => [
      {
        label: 'MRR',
        value: ctx.derived.mrr,
        subLabel?: 'Monthly Recurring Revenue',
        trend?: 12.5,         // percentage change
        trendLabel?: 'vs last month',
        unit?: '$',
        icon?: 'i-heroicons-currency-dollar',
        color?: 'emerald',    // 'primary' | 'emerald' | 'rose' | 'amber' | 'violet' | 'sky' | 'neutral'
        sparkline?: [120, 135, 148, 162, 180],  // mini chart
      },
    ],
  },
}

comparison-table

{
  type: 'comparison-table',
  config: {
    type: 'comparison-table',
    columns: [
      { key: 'name',  label: 'Plan' },
      { key: 'price', label: 'Price' },
      { key: 'users', label: 'Users' },
    ],
    rows: ctx => ctx.collections.plans.map(p => ({
      name: p.name, price: p.price, users: p.maxUsers
    })),
  },
}

feature-matrix

{
  type: 'feature-matrix',
  config: {
    type: 'feature-matrix',
    features: ['SSO', 'API Access', 'Custom Domain', 'SLA'],
    entities: ctx => ctx.collections.competitors.map(c => ({
      name: c.name,
      coverage: { SSO: c.hasSso, 'API Access': 'partial', 'Custom Domain': false, SLA: c.hasSla }
      // value: true | false | 'partial'
    })),
  },
}

timeline

{
  type: 'timeline',
  config: {
    type: 'timeline',
    items: ctx => ctx.collections.milestones.map(m => ({
      title: m.name,
      description?: m.notes,
      date?: m.targetDate,
      status?: m.done ? 'done' : m.current ? 'current' : 'upcoming',
      icon?: 'i-heroicons-flag',
    })),
  },
}

showWhen on VizDef

All viz types support showWhen to conditionally render:

{
  type: 'bar-chart',
  showWhen: ctx => ctx.collections.months.length > 0,
  config: { ... }
}

Custom Viz Types

Custom viz must be registered via defineProtokitExtension. See references/extensions.md.

{
  type: 'myns:heatmap',   // 'namespace:name'
  title?: 'Activity Heatmap',
  showWhen?: ctx => true,
  config?: { /* passed as props to your component */ }
}

CollectionCalendarConfig (for collection calendar views)

Used in LayoutItem with view: 'calendar':

{
  dateField: 'scheduledDate',     // required
  titleField: 'name',             // required
  idField?: '_id',
  endDateField?: 'endDate',
  timeField?: 'startTime',        // HH:mm
  endTimeField?: 'endTime',       // HH:mm
  allDayField?: 'isAllDay',       // boolean field; absent = all-day
  statusColorMap?: { scheduled: 'blue', done: 'green', cancelled: 'red' },
  defaultColor?: 'neutral',
}

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts18d3 checks · Risk SAFE
  • Gen Agent Trust Hub18d

    This skill provides a framework for building schema-driven prototypes in Nuxt 4. It handles data persistence using local browser storage and optional server synchronization. It follows secure practices such as offering AES-GCM encryption for local data and using standard framework protections against data injection. No malicious code or security threats were detected.

  • Socket18d

    No alerts

  • Snyk18d

    Risk: LOW · No issues

Signed by skilld at b4e1a3f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 15 hours ago.

Activeupdated 3 weeks ago

README badge

README badge for onmax/nuxt-skills/nuxt-protokit