PHPackages                             statamic-rad-pack/typesense - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search & Filtering](/categories/search)
4. /
5. statamic-rad-pack/typesense

ActiveLibrary[Search & Filtering](/categories/search)

statamic-rad-pack/typesense
===========================

typesense search driver for Statamic

v3.1.0(2mo ago)66.7k↓36.4%3MITPHPPHP ^8.2CI passing

Since Aug 19Pushed 1mo ago5 watchersCompare

[ Source](https://github.com/statamic-rad-pack/typesense)[ Packagist](https://packagist.org/packages/statamic-rad-pack/typesense)[ Docs](https://github.com/statamic-rad-pack/typesense)[ RSS](/packages/statamic-rad-pack-typesense/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (16)Versions (23)Used By (0)

Statamic Typesense Driver
=========================

[](#statamic-typesense-driver)

This addon provides a [Typesense](https://typesense.org) search driver for Statamic sites.

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 10+
- Statamic 5
- Typesense 0.2+

### Installation

[](#installation)

```
composer require statamic-rad-pack/typesense
```

Add the following variables to your env file:

```
TYPESENSE_HOST=http://127.0.0.1
TYPESENSE_API_KEY=
```

Add the new driver to the `statamic/search.php` config file:

```
'drivers' => [

    // other drivers

    'typesense' => [
        'client' => [
    	    'api_key' => env('TYPESENSE_API_KEY', 'xyz'),
            'nodes' => [
                [
                    'host' => env('TYPESENSE_HOST', 'localhost'),
                    'port' => env('TYPESENSE_PORT', '8108'),
                    'path' => env('TYPESENSE_PATH', ''),
                    'protocol' => env('TYPESENSE_PROTOCOL', 'http'),
                ],
            ],
            'nearest_node' => [
                'host' => env('TYPESENSE_HOST', 'localhost'),
                'port' => env('TYPESENSE_PORT', '8108'),
                'path' => env('TYPESENSE_PATH', ''),
                'protocol' => env('TYPESENSE_PROTOCOL', 'http'),
            ],
            'connection_timeout_seconds' => env('TYPESENSE_CONNECTION_TIMEOUT_SECONDS', 2),
            'healthcheck_interval_seconds' => env('TYPESENSE_HEALTHCHECK_INTERVAL_SECONDS', 30),
            'num_retries' => env('TYPESENSE_NUM_RETRIES', 3),
            'retry_interval_seconds' => env('TYPESENSE_RETRY_INTERVAL_SECONDS', 1),
        ],
    ],
],
```

You can optionally publish the config file for this package using:

```
php artisan vendor:publish --tag=statamic-typesense-config

```

### Search Settings

[](#search-settings)

Any additional settings you want to define per index can be included in the `statamic/search.php` config file. The settings will be updated when the index is created.

```
'articles' => [
    'driver' => 'typesense',
    'searchables' => ['collection:articles'],
    'fields' => ['id', 'title', 'url', 'type', 'content', 'locale'],
    'settings' => [
        'schema' => [
            /*
                Pass an optional schema, see the Typesense documentation for more info:
                https://typesense.org/docs/26.0/api/collections.html#with-pre-defined-schema
            */
            'fields' => [
                [
                  'name'  => 'company_name',
                  'type'  => 'string',
                ],
                [
                  'name'  => 'num_employees',
                  'type'  => 'int32',
                  'sort'  => true,
                ],
                [
                  'name'  => 'country',
                  'type'  => 'string',
                  'facet' => true,
                ],
            ],
        ],
        /*
            Pass any of the options from https://typesense.org/docs/26.0/api/search.html#search-parameters
        */
        'search_options' => [
            /*
                eg Specify a custom sort by order, see the Typesense documentation for more info:
                https://typesense.org/docs/guide/ranking-and-relevance.html#ranking-based-on-relevance-and-popularity
            */
            'sort_by' => '_text_match(buckets: 10):desc,weighted_score:desc',
        ],

        /*
            Set this to true to maintain the sort score order that Typesense returns
        */
        'maintain_rankings' => false,
    ],
],
```

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance89

Actively maintained with recent releases

Popularity32

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 87.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~32 days

Recently: every ~60 days

Total

19

Last Release

62d ago

Major Versions

v1.4.1 → v2.0.02025-01-27

v2.4.0 → v3.0.02026-01-29

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/44739?v=4)[Jack McDade](/maintainers/jackmcdade)[@jackmcdade](https://github.com/jackmcdade)

![](https://avatars.githubusercontent.com/u/1669353?v=4)[Statamic](/maintainers/statamic)[@statamic](https://github.com/statamic)

![](https://avatars.githubusercontent.com/u/51899?v=4)[Ryan Mitchell](/maintainers/ryanmitchell)[@ryanmitchell](https://github.com/ryanmitchell)

---

Top Contributors

[![ryanmitchell](https://avatars.githubusercontent.com/u/51899?v=4)](https://github.com/ryanmitchell "ryanmitchell (81 commits)")[![duncanmcclean](https://avatars.githubusercontent.com/u/19637309?v=4)](https://github.com/duncanmcclean "duncanmcclean (7 commits)")[![simonerd](https://avatars.githubusercontent.com/u/7941370?v=4)](https://github.com/simonerd "simonerd (4 commits)")[![bastihilger](https://avatars.githubusercontent.com/u/1419634?v=4)](https://github.com/bastihilger "bastihilger (1 commits)")

---

Tags

statamic-addontypesensesearchstatamictypesense

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/statamic-rad-pack-typesense/health.svg)

```
[![Health](https://phpackages.com/badges/statamic-rad-pack-typesense/health.svg)](https://phpackages.com/packages/statamic-rad-pack-typesense)
```

###  Alternatives

[statamic-rad-pack/meilisearch

meilisearch search driver for Statamic

1661.7k](/packages/statamic-rad-pack-meilisearch)[typesense/laravel-scout-typesense-driver

Laravel Scout Driver for Typesense

144637.2k3](/packages/typesense-laravel-scout-typesense-driver)[mailerlite/laravel-elasticsearch

An easy way to use the official PHP ElasticSearch client in your Laravel applications.

934529.3k2](/packages/mailerlite-laravel-elasticsearch)[jeroen-g/explorer

Next-gen Elasticsearch driver for Laravel Scout.

397612.3k](/packages/jeroen-g-explorer)[marcorieser/statamic-live-search

A Statamic Live Search realized with Laravel Livewire.

2210.5k](/packages/marcorieser-statamic-live-search)[cmsig/seal

Search Engine Abstraction Layer

32207.9k53](/packages/cmsig-seal)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)