diff --git a/README.md b/README.md
index 5bbe05e..891e334 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,78 @@
-# ngx-turnstile - Cloudflare Turnstile Component for Angular
-An easy to use component for implementing [Cloudflare Turnstile](https://blog.cloudflare.com/turnstile-private-captcha-alternative/) in Angular.
\ No newline at end of file
+# Cloudflare Turnstile Component for Angular
+
+## ngx-turnstile
+
+An easy to use component for implementing [Cloudflare Turnstile](https://blog.cloudflare.com/turnstile-private-captcha-alternative/) in Angular.
+
+## Installation
+
+Add this library to your Angular project using npm or yarn.
+
+```bash
+yarn add ngx-turnstile
+npm install ngx-turnstile --save
+```
+
+## Quickstart
+
+To start, import the TurnstileModule in your app module.
+
+```typescript
+// app.module.ts
+import { TurnstileModule } from "ngx-turnstile";
+import { BrowserModule } from "@angular/platform-browser";
+import { MyApp } from "./app.component.ts";
+
+@NgModule({
+  bootstrap: [MyApp],
+  declarations: [MyApp],
+  imports: [BrowserModule, TurnstileModule],
+})
+export class MyAppModule {}
+```
+
+After that, you are free to use the component anywhere:
+
+```typescript
+// app.component.ts
+import { Component } from "@angular/core";
+
+@Component({
+  selector: "my-app",
+  template: `<ngx-turnstile
+    [siteKey]="siteKey"
+    (resolved)="sendCaptchaResponse($event)"
+    theme="auto"
+    [tabIndex]="0"
+  ></ngx-turnstile>`,
+})
+export class MyApp {
+  sendCaptchaResponse(captchaResponse: string) {
+    console.log(`Resolved captcha with response: ${captchaResponse}`);
+  }
+}
+```
+
+## API
+
+The component supports these options as input:
+
+- `siteKey`
+- `action`
+- `cData`
+- `theme`
+- `tabIndex`
+
+These options are well documented in the [Cloudflare Docs](https://developers.cloudflare.com/turnstile/get-started/client-side-rendering/#configurations). The letter cases are adapted to camelCase to facilitate easy migration from `ng-recaptcha`.
+
+### Events
+
+- `resolved(response: string)`. Occurs when the CAPTCHA resolution value changed.
+
+### Example
+For those who prefer examples over documentation, simply clone the repository and run
+```bash
+$ yarn install
+$ ng build ngx-turnstile
+$ ng serve ngx-turnstile-demo
+```
\ No newline at end of file