> For the complete documentation index, see [llms.txt](https://arlinear.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://arlinear.gitbook.io/documentation/react/getting-started.md).

# Getting Started

### React Setup

Install the Arlinear Quiz package in your project.

```
npm install @arlinear/quiz-react
```

```javascript
import { ArlinearQuiz } from "@arlinear/quiz-react";
import "@arlinear/quiz-react/dist/public/style.css";
```

#### Overview of Components 

```jsx
/* Renders Quiz */
<ArlinearQuiz 
    quizKey="ba777045-7033-4701-b17b-da9e90dcd41e"
    primaryKey="emily@school.com" // if empty, this does not save grades
/>

/* Render Quiz & Displays results on quiz submit */
<ArlinearQuizWithResult
    quizKey="ba777045-7033-4701-b17b-da9e90dcd41e"
    onSubmit={ () => {} } // function to run onSubmit
    onTryAgain={ () => {} } // function to run onTryAgain (at the end there is a "Try again button")
/>
```

#### Live Example

{% embed url="<https://codesandbox.io/embed/ancient-star-lnngkq?autoresize=1&fontsize=14&hidenavigation=1&theme=dark>" %}