Definicija
Polaris je Shopify sistem dizajna za aplikacije: komponente, stilovi i pravila zbog kojih aplikacija izgleda i ponaša se kao Shopify admin. Danas dolazi kao Polaris web komponente, koje se koriste u App Home delu i u admin, checkout, customer account i POS ekstenzijama. Starija biblioteka Polaris React je zastarela i više se ne održava.
Kako Polaris radi
Polaris je sistem dizajna iza Shopify aplikacija: skup komponenti interfejsa, stilova i pravila zbog kojih aplikacija izgleda i ponaša se kao Shopify admin u kom radi. Shopify ga opisuje kao svoj „objedinjeni UI framework zasnovan na web komponentama“, a koriste ga sve površine na kojima se aplikacije prikazuju.[1]
Te površine su App Home, odnosno glavna stranica aplikacije u adminu, zatim admin UI ekstenzije, checkout UI ekstenzije, customer account UI ekstenzije i POS UI ekstenzije. Svaka površina ima svoj podskup Polaris web komponenti.[1] Komponente su izvorni elementi interfejsa napravljeni uz remote-dom, Shopify biblioteku za interfejse na više platformi, i imaju ugrađenu pristupačnost: semantički HTML, rad sa tastaturom, ARIA atribute, upravljanje fokusom i odgovarajući kontrast boja.[2]
U App Home delu aplikacija se prikazuje u iframe-u i sa ostatkom admina komunicira preko App Bridge-a, JavaScript SDK-a. Polaris daje komponente, a App Bridge povezuje aplikaciju sa adminom.[3] U praksi programer u zaglavlje HTML-a doda dve script oznake, jednu za App Bridge i jednu za Polaris, i pravi stranice od elemenata kao što su s-page, s-section i s-button.[3][4] Pošto prate Web Components standard, komponente rade u svakom framework-u ili u čistom JavaScript-u, kao običan button ili input.[3] Stari sajt dokumentacije polaris.shopify.com sada preusmerava na ove reference na shopify.dev.
Verzije Polarisa: React, web komponente i Polaris 2
Pod imenom „Polaris“ kroz godine se krio različit kod, pa dva programera za istu aplikaciju mogu da ponude vrlo različit posao:
| Verzija | Status | Šta znači za aplikaciju |
|---|---|---|
Polaris React (@shopify/polaris) | Zastareo (deprecated). Repozitorijum je arhiviran i više neće dobijati izmene ni održavanje.[5] | Postojeće aplikacije rade, ali delovi interfejsa napravljeni njime zadržavaju sadašnji izgled admina.[6] |
| Polaris web komponente | Objavljene 1. oktobra 2025; Shopify ih preporučuje za sav novi razvoj.[5] | Ne zavise od framework-a: React, Vue, stranice renderovane na serveru ili čist JavaScript.[3] |
| Polaris 2.0 za App Home | Verzija koju opisuje aktuelna App Home dokumentacija.[3] | Prati novi izgled Shopify admina, sa novim okvirom, navigacijom i vizuelnim stilom.[6] |
Polaris 2.0 menja izgled komponenti, a ne način na koji se koriste. Ima iste komponente, svojstva i događaje kao Polaris 1.1, pa markup koji radi na 1.1 radi i na 2.0. Aplikacija napravljena isključivo od Polaris web komponenti prelazi na novi izgled admina samim učitavanjem verzije 2.0, dok aplikacija na Polarisu 1, ili bilo koji deo interfejsa koji još koristi Polaris React, zadržava sadašnji izgled.[6] Biblioteka ima verzije, a Shopify preporučuje stabilni kanal za glavnu verziju, koji uvek daje najnovije stabilno izdanje.[4]
App Home može da se napravi na dva načina. Iframe model radi sa bilo kojim framework-om, hostujete ga vi i odgovara i javnim i custom aplikacijama. App Home UI ekstenziju hostuje Shopify, radi na Preact-u, ima ograničenje od 64 KB kompresovanog paketa, sme da koristi samo Polaris web komponente i dostupna je samo za custom distribuciju.[7]
Polaris i Built for Shopify
Za aplikacije u App Store-u izvorni izgled je pisani uslov. Built for Shopify kriterijum 4.1 kaže da aplikacija treba uglavnom da izgleda i da se ponaša kao Shopify admin i da njen interfejs prati osnovni izgled Shopify-ja.[8] Navedeni razlozi za odbijanje liče na Polaris kontrolnu listu:[8]
- Primarna dugmad u potpuno drugoj boji od Polarisa, na primer zelena ili ljubičasta.
- Serifni ili kaligrafski font za veći deo sadržaja, ili tekst znatno veći ili manji od teksta u adminu.
- Pozadina u boji koja se jako razlikuje od admina, na primer crna.
- Veći deo sadržaja van kartica koje liče na kartice u adminu.
- Tekst koji ne ispunjava WCAG 2.1 AA kontrast.
- Modal napravljen zastarelom Polaris Fullscreen bar komponentom umesto aktuelnih App Bridge komponenti za prozor i stranicu.
Shopify smernice za dizajn aplikacija idu korak dalje i preporučuju Polaris komponente za sve aplikacije ugrađene u admin, uz obrazloženje da će aplikacija koja koristi Polaris da se razvija zajedno sa adminom.[9] Boje su mesto gde aplikacije najčešće odlutaju. Shopify pravilo je da uloge boja pokazuju stanje, na primer neisporučenu porudžbinu ili neuspelu sinhronizaciju, i da se nikad ne koriste za razlikovanje kategorija.[10] U našem pregledu Polaris tokena boja, hex vrednosti i tonova pokazujemo kako se te uloge prevode u konkretne vrednosti.
Primer: custom aplikacija za status fiskalizacije
Uzmimo zamišljenu domaću prodavnicu koja fiskalizuje porudžbine preko integracije sa ESIR-om, i u kojoj troje ljudi svakog dana proverava da li je svaki račun prošao. Prodavnica naručuje custom aplikaciju sa četiri ekrana: spisak porudžbina sa statusom, detalj računa, ponovno slanje i podešavanja. Svi brojevi su ilustrativni.
- Sa Polaris web komponentama u App Home delu. Naslovna traka i navigacija dolaze iz App Bridge-a, nesačuvane izmene idu kroz traku za čuvanje iz admina, a status je Polaris badge čiji ton prati stanje:
successza „Fiskalizovano“,warningza „Na čekanju“,criticalza „Greška“.[3][10][8] Kada admin pređe na novi izgled, posao se svodi na učitavanje Polarisa 2.0 i proveru delova koje Polaris ne kontroliše.[6] - Sa sopstvenim React interfejsom u bojama brenda. Zelena dugmad, crno zaglavlje, sopstveni meni i statusi obojeni po kategoriji proizvoda umesto po stanju računa. Zaposleni po ceo dan prelaze između dva načina rada, a svaki redizajn admina znači ručno prepravljanje sva četiri ekrana.
Na 200 porudžbina dnevno, razlika između badge-a koji jasno kaže „Greška“ i zelenog natpisa koji liči na ostale je razlika između računa koji je ispravljen istog dana i računa koji se otkrije na kraju meseca.
Polaris vs App Bridge
| Polaris | App Bridge | |
|---|---|---|
| Šta je | Sistem dizajna i UI komponente[1] | JavaScript SDK koji povezuje aplikaciju sa Shopify adminom[3] |
| Šta dobijate | Dugmad, kartice, forme, tabele, badge-ove i ostali sadržaj stranice | Naslovnu traku, navigaciju u adminu, traku za čuvanje i prozore aplikacije[9][8] |
| Gde radi | App Home i admin, checkout, customer account i POS ekstenzije[1] | Aplikacije ugrađene u Shopify admin[3] |
| Verzije | Biblioteka sa verzijama, trenutno Polaris 2.0[4] | Odvojeno; verzija Polarisa ne menja App Bridge elemente[6] |
FAQ
Da li je Polaris React zastareo?
Jeste. Shopify repozitorijum kaže da je biblioteka Polaris React zastarela, arhivirana i da više neće dobijati izmene ni održavanje. Za novi razvoj Shopify preporučuje Polaris web komponente, objavljene 1. oktobra 2025.[5]
Da li checkout ekstenzije koriste Polaris?
Koriste. Checkout UI ekstenzije, kao i admin, customer account i POS ekstenzije, prikazuju se kroz Polaris web komponente. Svaka površina ima svoj podskup komponenti.[1]
Da li custom aplikacija mora da koristi Polaris?
Built for Shopify važi za aplikacije u App Store-u, pa se custom aplikacija prema njemu ne ocenjuje. Shopify ipak preporučuje Polaris za svaku aplikaciju ugrađenu u admin, a App Home UI ekstenzija sme da koristi samo Polaris web komponente.[7][9]
Šta je Polaris 2?
Polaris 2.0 je verzija Polaris web komponenti za App Home koja prati novi izgled Shopify admina. Zadržava iste komponente i svojstva kao Polaris 1.1.[6]
Mogu li da koristim Polaris bez React-a?
Možete. Polaris web komponente prate Web Components standard, pa rade sa svakim framework-om ili u čistom JavaScript-u.[3]
Ukratko
Polaris je Shopify sistem dizajna za aplikacije, a danas to znači Polaris web komponente u App Home delu i na svim površinama za ekstenzije. Polaris React je zastareo, a Polaris 2.0 drži aplikaciju u koraku sa novim adminom. Za aplikaciju u App Store-u izvorni izgled je Built for Shopify uslov; za custom aplikaciju to je ono što zaposlene čini bržim. Naš tim za razvoj Shopify aplikacija po meri podrazumevano radi na Polaris web komponentama, a tekst o pravilima Shopify App Store-a pokriva pregled kroz koji prolaze javne aplikacije.
Izvori
Koristimo samo primarne izvore: zvaničnu dokumentaciju, stranice proizvoda i propise. Svaki link je proveren na navedeni datum.
- Shopify Dev. Polaris references. Pristupljeno 18th Nov 2026.
- Shopify Dev. Using web components. Pristupljeno 18th Nov 2026.
- Shopify Dev. App Home iframe apps. Pristupljeno 18th Nov 2026.
- Shopify Dev. Versioning for web components. Pristupljeno 18th Nov 2026.
- Shopify on GitHub. Polaris React (archived repository). Pristupljeno 18th Nov 2026.
- Shopify Dev. Update your app for Polaris 2. Pristupljeno 18th Nov 2026.
- Shopify Dev. Apps in App Home. Pristupljeno 18th Nov 2026.
- Shopify Dev. Built for Shopify requirements. Pristupljeno 18th Nov 2026.
- Shopify Dev. App Design Guidelines. Pristupljeno 18th Nov 2026.
- Shopify Dev. Visual design. Pristupljeno 18th Nov 2026.
Treba vam ovo u prodavnici?
Pogledajte usluguChecklista koju prolazimo pre nego što dotaknemo kod klijenta
Stiže vam na email, uz nekoliko kratkih poruka u naredne dve nedelje: šta najčešće vidimo na Shopify prodavnicama i šta zaista pomaže.