Astro Itchio Publisher

Get Started

1. Install the package:

   npm install astro-itchio-publisher

2. Configure in astro.config.mjs:

   Choose your method:

   • Manual Upload Method (Path Fixing + Zip Only):

     No upload config needed—just add the integration.

     
         import { defineConfig } from 'astro/config';
         import astroItchioPublisher from 'astro-itchio-publisher';
         
         export default defineConfig({
           integrations: [
             astroItchioPublisher()
           ],
         });
                         

   • API Method (Automated Upload):

     
     import { defineConfig } from 'astro/config';
     import astroItchioPublisher from 'astro-itchio-publisher';
     
     export default defineConfig({
       integrations: [
         astroItchioPublisher({
           itchProject: 'your-username/your-game:html5',
           apiKey: 'your-itchio-api-key', // From https://itch.io/user/settings/api-keys
         }),
       ],
     });
                     

   • Butler Method (Automated Upload):

     Install Butler: Download and run butler login.

     
     import { defineConfig } from 'astro/config';
     import astroItchioPublisher from 'astro-itchio-publisher';
     
     export default defineConfig({
       integrations: [
         astroItchioPublisher({
           itchProject: 'your-username/your-game:html5',
           useButler: true,
         }),
       ],
     });
                     

3. Build your project:

   npm run build

   Fixes paths and zips dist into astro-itchio-publisher-dist.zip. For API/Butler, it uploads automatically; for manual, upload the zip to Itch.io yourself.