Skip to content

Documentation for Astro integration is outdated and causing build errors (Astro 5) #746

@alomia

Description

@alomia

Summary

The Astro integration documentation is currently outdated and does not work correctly with the latest stable version of Astro (5.x). Following the official guide results in build errors and configuration issues. The documentation needs to be updated to reflect the current Astro ecosystem and modern Vite behavior to ensure a smooth setup process.

Steps to Reproduce

Description

The current Astro integration guide for Preline UI
https://preline.co/docs/frameworks-astro.html

is outdated and does not work correctly with Astro 5.x (Vite 5).

Following the official documentation results in build/runtime errors related to:

  • CSS imports that are not exported by the package (e.g. variants.css)
  • Direct references to node_modules in <script> tags
  • Missing clarification about required setup for modern Astro projects

These issues prevent a clean installation using the documented steps and create unnecessary friction for developers trying to adopt Preline with Astro.


Expected Behavior

  • The Astro documentation should be validated against the latest stable Astro version.
  • The setup instructions should work without modification.
  • Examples should follow modern Vite/Astro best practices.

Impact

This negatively affects developer experience and gives the impression that Astro is not properly supported, even though the issue appears to be documentation-related.


Please update the Astro integration guide to reflect compatibility with current versions of Astro.

Thank you.

Demo Link

https://preline.co/docs/frameworks-astro.html

Expected Behavior

No response

Actual Behavior

No response

Screenshots

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions