Skip to content

stscoundrel/dictionary-revalidator

Repository files navigation

Dictionary Revalidator

Kotlin / Spring Boot API for triggering revalidation actions in various dictionary websites using incremental static generation.

Abstracts a few apikey / secret guarded endpoints in various dictionary projects under the same umbrella, allowing revalidation of pages using one API only.

Development

mvn clean && mvn spring-boot:run

The app requires few env vars. See .env.example.

Build

Build Docker image:

docker-compose build

Run Docker image:

docker-compose up

Why though

This is essentially just a web service version of existing revalidation scripts shipped with projects like

Each of those sites contains too many statically generated pages to be deployed in one go to Vercel, as they hit Vercels per-build file limit. The solution has been to deploy them with only few core pages and use ISR to generate the pages as they are accessed for the first time. However, this first load may be bit too slow for casual browser and it actually consumes more resources than triggering API endpoint based revalidation. Considering that these sites are all hosted on free tiers, saving Vercels resources is both polite and required. Therefore, whenever new changes are deployed, new revalidation for tens of thousands of pages is needed.