eduardweb.
ShopifyIntermediar#shopify#app-store#polaris#remix

Shopify Polaris + Remix: Cum treci de review-ul dur din App Store fără 3 respingeri

De Andreea Crăciun, 1 nov. 2026 · 20 vizualizări · 3 like-uri

Postat 1 nov. 2026
typescript
import type { LoaderFunctionArgs } from "@remix-run/node";
import { json } from "@remix-run/node";
import { authenticate } from "../shopify.server";

export const loader = async ({ request }: LoaderFunctionArgs) => {
  // Aruncă automat Response de redirect dacă sesiunea lipsește sau a expirat
  const { admin, session } = await authenticate.admin(request);

  const response = await admin.graphql(`
    #graphql
    query getShopDetails {
      shop {
        name
        myshopifyDomain
      }
    }
  `);

  const data = await response.json();

  return json({
    shop: data.data.shop,
    shopOrigin: session.shop,
  });
};

Dacă vrei să publici o aplicație în Shopify App Store, combinația oficială Remix + Polaris îți ia jumătate din munca de infrastructură. Totuși, reviewerii Shopify sunt extrem de tipicari și verifică manual fiecare scenariu de eroare. La un proiect recent pentru un client cu vreo 1.400 de comenzi pe zi, ne-au respins aplicația de două ori fix pe detalii de navigare înainte să ne aprobe.

De ce Remix și care e compromisul cu Polaris

Template-ul oficial bazat pe @shopify/shopify-app-remix este excelent pentru că rezolvă din cutie OAuth-ul, verificarea sesiunilor prin App Bridge și sincronizarea scope-urilor API. Scapi de vreo 30-40 de ore de boilerplate pe care le pierdeai pe vremuri când foloseai Express sau o clonă de Next.js configurată de mână.

Trade-off-ul e însă legat de rigiditate. Polaris e gândit exclusiv să arate ca Shopify Admin. Merge fantastic dacă faci tabele simple, formulare de setări sau carduri de metrici, pentru că reviewerii acordă puncte bonus la consistență vizuală. În schimb, devine un coșmar dacă ai nevoie de componente atipice sau interfețe foarte dinamice: e greu de suprascris, documentația versiunilor noi v12+ are goluri, iar reconcilierea SSR cu App Bridge pe client dă ocazional erori de hidratare ciudate.

Unde te prind reviewerii la Shopify App Review

Reviewerii lor testează aplicațiile folosind un mediu izolat și scenarii limită la care rareori te gândești în local. Am strâns o listă cu punctele critice care aduc automat respingerea:

  1. Deep linking fără sesiune activă: Reviewerul va lua un URL adânc din app (de exemplu /app/settings) și îl va deschide într-un tab nou de browser, complet anonim, fără query params de shop sau host. Dacă aplicația ta aruncă un ecran alb sau eroare 500 în loc să facă redirect curat către instalare/login prin App Bridge, ești respins pe loc.
  2. Webhooks obligatorii de GDPR: Mulți uită de endpoint-urile obligatorii de compliance (customers/data_request, customers/redact, shop/redact). Chiar dacă nu stochezi date cu caracter personal, aceste endpoint-uri trebuie înregistrate în panoul Shopify Partners și să returneze HTTP 200 imediat ce primesc payload-ul semnat cu HMAC.
  3. Billing API integrat incorect: Dacă ai un plan cu plată, n-ai voie sub nicio formă să ceri date de card extern (de ex. un checkout separat pe Stripe). Totul trebuie să treacă prin billing.request din SDK-ul de Remix. Dacă reviewerul găsește vreun formular de plată propriu, riști inclusiv blocarea contului de partener.

Cum protejezi rutele corect

În fiecare loader de Remix trebuie să folosești helperul authenticate.admin(request). Acesta știe automat să returneze headerele de redirect speciale (X-Shopify-API-Request-Failure-Reauthorize) pe care le prinde App Bridge în iframe pentru a reîmprospăta token-ul de sesiune fără să crape pagina.

Dacă respecți convențiile Polaris pe layout și ai toate verificările de sesiune puse la punct, procesul de review durează între 5 și 8 zile lucrătoare. Voi ce alte ciudățenii ați mai pățit la review-urile recente de la Shopify?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.