Build a React app

This tutorial teaches you how to build a React app for Freshdesk on Platform 3.0, one small step at a time.

By the end, you will have:

• A full page that lists, creates, and deletes tickets.
• A ticket sidebar with buttons to change status and priority.
• A custom installation page that collects a Freshdesk domain and API key.
• A packaged app ready to submit to the marketplace.

You will use only the tools the platform gives you: the FDK for scaffolding and running the app, request templates for API calls, and Crayons for UI.

1. Create and run a React app with the FDK.
2. Read the starter template so you know where your code goes.
3. Register the full page and ticket sidebar placements.
4. Store the Freshdesk domain and API key as installation parameters.
5. Call the Freshdesk API with request templates (no keys in the browser).
6. Build UI with Crayons components.
7. Add a third-party npm library — react-redux — and use it in one place.
8. Pack the app and upload it for review.

You have written React before and can read JavaScript. You do not need prior Freshworks experience — every platform concept is introduced where you first need it.

• Do the steps in order. Each page ends in a working state.
• Keep a Freshdesk account open in another tab so you can see the app render.
• If you get stuck, compare your file against Superstack, a reference app that ships the same features in production shape.

Ready? Start with the Prerequisites.