KO
|
EN
gitlite — search
Search
#python
#java
#python3
#arduino
#golang
#machine-learning
#rust
#html
#flask
#javascript
#seismology
#nodejs
isr-platform-shield
★ 14
Open GitHub ↗
Shielded ISR platform
Download README (.md)
Explore Similar Repositories
awesome-causal-ai
:
A meticulously curated collection of cutting-edge research, frameworks, and methodologies in Causal Artificial Intelligence.
alpha2026
:
alpha2026
whatsmeow-node
:
TypeScript bindings for the Go library go.mau.fi/whatsmeow, via a minimal c-shared bridge loaded with koffi.
sfsymbols
:
Apple's SF Symbols icons for React applications on Apple platforms.
heidelberg_generative_lectures
:
No description available.
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
isr-platform-shield
?
Download (.md)
# Shielded Platform ISR > [!NOTE] > This project is experimental and all practices herein should be evaluated as such. A two-app Next.js system providing shielded ISR caching for multi-tenant platforms on Vercel. The shield layer provides cache protection during Core app deployments, enabling cache warming and preventing slow first requests. ## Before you start Run the setup script: `pnpm setup` This installs dependencies and injects the project `bin` dir into your PATH, which allows you to use validation helpers. Copy `env.example` to `.env.local` in each app you run: - **Core** (`apps/core`): `NEXT_PUBLIC_ROOT_DOMAIN`, `KV_REST_API_URL`, `KV_REST_API_TOKEN` - **Shield** (`apps/shield`): `CORE_HOST`, `SHIELD_HOST`, `NEXT_PUBLIC_ROOT_DOMAIN` `@platform/config` reads those env vars for domain and deployment URLs. Subdomain names for validation live in `packages/config/validation.json` — copy from `validation.example.json` or run `pnpm setup`. See [packages/config/README.md](/packages/config/README.md). Seed example tenant subdomains in Upstash Redis (required before cache validation and subdomain routes work): ```bash pnpm seed ``` See [seeding](/docs/SEEDING.md) for prerequisites, what gets created, and troubleshooting. ## Shielded ISR Architecture "Normal" ISR (Incremental Static Regeneration) in Next.js caches pages tied to a deployment. When you deploy a new version, the ISR cache is replaced and must be rebuilt, causing slow first requests for pages not generated during build. **Shielded ISR** solves this by providing a protective cache layer that serves content while the Core app warms its cache (via active reading) after deployment. This enables: - **Deferred prerendering**: Defer static page generation until after build, then pre-warm by requesting each page - **Deployment Protection**: Shield cache serves content while Core app ISR cache rebuilds - **Performance**: Fast responses during the critical post-deployment period See the [architecture](/docs/ARCHITECTURE.md) and [data flow](/docs/DATA_FLOW.md) docs for more information. ## Validation Validating deployment behavior is done through the `validator` package. You can run `pnpm validate` from the root of the monorepo to test whether certain requests are being routed to the correct pages. See the [validation doc](/docs/VALIDATION.md) for more details.
