---
## Table of Contents
## 📋 Table of Contents
* [Requirements](#-requirements)
* [Installation](#-installation)
* [Features](#-features)
* [Usage](#-usage)
* [Configuration](#-configuration)
* [Development](#-development)
* [Contributing](#-contributing)
* [License](#-license)
## 📋 Requirements
* Astro ^5.0.0
* Strapi ^5.0.0
## 📦 Installation
```bash
npm install @sensinum/astro-strapi-loader
# or
yarn add @sensinum/astro-strapi-loader
```
## 🚀 Features
* Easy integration with Astro and Strapi
* Automatic data loading from Strapi API
* Query, filtering and population capabilities - [Strapi 5 Documentation](https://docs.strapi.io/cms/api/rest/parameters)
* Authorization token support
* Astro collections system integration
* TypeScript typing
## 🖥️ Usage
1. Add the integration to your `src/content.config.ts`:
```ts
import { generateCollections } from '@sensinum/astro-strapi-loader';
let strapiCollections: any = {};
try {
strapiCollections = await generateCollections({
url: import.meta.env.STRAPI_URL,
token: import.meta.env.STRAPI_TOKEN,
}, [{ // leave empty [] to fetch all the collections based on default Strapi settings
name: "my-collection",
query: {
populate: {
// ...
},
},
}, 'yet-another-collection']);
} catch (error) {
console.error(error);
}
export const collections = {
...strapiCollections,
};
```
2. Use in your Astro component:
```jsx
---
import { getCollection } from 'astro:content';
import { fetchContent } from '@sensinum/astro-strapi-loader';
// Basic usage with Astro Collections
const myCollection = await getCollection('my-collection');
// Basic usage with direct Strapi Content API fetch
const myCollection = await fetchContent({
url: import.meta.env.STRAPI_URL,
token: import.meta.env.STRAPI_TOKEN,
contentType: 'my-collection',
queryParams: {
populate: {
// ...
},
filters: {
// ...
},
sort: ['publishedAt:desc'],
},
});
---
