@appgram/react

React library for integrating Appgram portal features with pre-built UI components and headless hooks.

Installation

npm install @appgram/react

yarn add @appgram/react

pnpm add @appgram/react

Quick Start

Wrap your app with AppgramProvider:

import { AppgramProvider } from '@appgram/react'

function App() {
  return (
    <AppgramProvider apiKey="your-api-key">
      <YourApp />
    </AppgramProvider>
  )
}

Use components or hooks:

import { WishList, useWishes } from '@appgram/react'

// Pre-built component
function Feedback() {
  return <WishList />
}

// Or headless hook for custom UI
function CustomFeedback() {
  const { wishes, isLoading } = useWishes()

  if (isLoading) return <div>Loading...</div>

  return (
    <ul>
      {wishes.map(wish => (
        <li key={wish.id}>{wish.title}</li>
      ))}
    </ul>
  )
}

Features

• Feedback & Wishboards - Collect feature requests with voting
• Roadmap - Display product roadmap with status columns
• Changelog - Show release notes and updates
• Help Center - Knowledge base with collections and articles
• Support - Ticket submission forms
• Status Page - Service status and incident tracking
• Surveys - Collect user feedback with forms
• Blog - Display blog posts and categories

Hooks

| Hook | Description | |------|-------------| | useWishes | Fetch and manage feature requests | | useVote | Handle voting on wishes | | useRoadmap | Fetch roadmap data | | useReleases | Fetch changelog releases | | useHelpCenter | Fetch help center collections | | useHelpArticle | Fetch individual articles | | useSupport | Submit support requests | | useStatus | Fetch status page data | | useSurvey | Fetch and submit surveys | | useContactForm | Fetch and submit contact forms | | useBlogPosts | Fetch blog posts |

Components

| Component | Description | |-----------|-------------| | WishList | Feature request list with voting | | SubmitWishForm | Form to submit new wishes | | RoadmapBoard | Kanban-style roadmap display | | ReleaseList | Changelog with release cards | | HelpCenter | Full help center with search | | SupportForm | Support ticket submission | | StatusBoard | Service status dashboard | | SurveyRenderer | Dynamic survey forms | | Blog | Blog listing with categories |

Documentation

Full documentation available at appgram.dev/docs

Requirements

• React 18.0.0 or higher

License

MIT