Why Astro PartytownSection titled Why Astro Partytown
If you’re using third-party scripts for things like analytics or ads, Partytown is a great way to make sure that they don’t slow down your site.
The Astro Partytown integration installs Partytown for you and makes sure it’s enabled on all of your pages.
InstallationSection titled Installation
Astro includes an
astro add command to automate the setup of official integrations. If you prefer, you can install integrations manually instead.
Run one of the following commands in a new terminal window.
If you run into any issues, feel free to report them to us on GitHub and try the manual installation steps below.
Manual InstallSection titled Manual Install
First, install the
Then, apply the integration to your
astro.config.* file using the
UsageSection titled Usage
Partytown should be ready to go with zero config. If you have an existing 3rd party script on your site, try adding the
If you open the “Network” tab from your browser’s dev tools, you should see the
partytown proxy intercepting this request.
ConfigurationSection titled Configuration
To configure this integration, pass a ‘config’ object to the
partytown() function call in
This mirrors the Partytown config object.
config.debugSection titled config.debug
Partytown ships with a
debug mode; enable or disable it by passing
debug mode is enabled, it will output detailed logs to the browser console.
config.forwardSection titled config.forward
Third-party scripts typically add variables to the
window object so that you can communicate with them throughout your site. But when a script is loaded in a web-worker, it doesn’t have access to that global
To solve this, Partytown can “patch” variables to the global window object and forward them to the appropriate script.
You can specify which variables to forward with the
config.forward option. Read more in Partytown’s documentation.
ExamplesSection titled Examples
- Browse projects with Astro Partytown on GitHub for more examples!