diff --git a/docs/astro.config.ts b/docs/astro.config.ts index 9d5e7579..ec1dd1c5 100644 --- a/docs/astro.config.ts +++ b/docs/astro.config.ts @@ -29,6 +29,10 @@ export default defineConfig({ label: "Usage", link: "/getting-started/usage/", }, + { + label: "Why Astro Integration Kit", + link: "/getting-started/why", + }, { label: "Showcase", link: "/getting-started/showcase/", diff --git a/docs/src/content/docs/getting-started/why.mdx b/docs/src/content/docs/getting-started/why.mdx new file mode 100644 index 00000000..b7e838c0 --- /dev/null +++ b/docs/src/content/docs/getting-started/why.mdx @@ -0,0 +1,24 @@ +--- +title: Why use Astro Integration Kit +description: Learn why you should use Astro Integration Kit to build your next Astro Integration. +--- + +Astro Integration Kit is a community-driven effort to improve the power, flexibility, and, most importantly, developer experience of creating Astro Integrations. + +We are creating the Astro Integration Kit because we want to create a robust, battle-tested suite of tools to make creating Astro integrations easier in the hopes that one day, this will become part of the core Astro framework. + +We constantly gather feedback from the entire community, from first-time integration builders to the seasoned Astro Core team. + +Astro Integration Kit is currently an experimental technology that's still subject to changes as we solidify the APIs. However, it was built from techniques used in production-level integrations across the Astro Ecosystem. + +Integrations typically require quite a low-level knowledge of Astro and Vite to be made successfully. So, Astro Integration Kit abstracts a lot of low-level implementation into easy-to-use utilities. Things such as Vite Virtual Modules or creating Typescript Declaration files for your users. + +Small utilities allow you to adhere to best practices with the minimum amount of code. + +Once we have a standard way of creating Astro Integrations, we can create content and guides much more easily using well-documented utilities, enabling more people to create more advanced integrations. + +:::note +We are constantly looking for feedback and contributions from the community. Whether it's contributing code, ideas or suggestions; feel free to create an issue on [our GitHub repository](https://github.com/florian-lefebvre/astro-integration-kit). + +Or get involved with the discussion on the [`#dev-integrations `channel](https://discord.com/channels/830184174198718474/1197638002764152843) of the official [Astro Discord server](https://astro.build/chat)! +::: \ No newline at end of file