Installation and first setup
Use Lumerelle-0.9.3-shopify.zip for a clean installation. Upload it in Shopify's themes area and configure it in preview first. Duplicate an existing theme before replacing it. The demo ZIP includes sample store resource selections; it does not create those products or collections in another store. Installing a theme does not configure products, discounts, payment providers or shipping rates.
In the theme editor, set your logo, favicon, fonts and brand colors. Select your navigation menu in Header. Select real products and collections in mood cards, collection cards, product discovery and the candle designer. Replace sample images and copy, and enter your footer contact details and menus. Add testimonials only when you have genuine customer statements. Complete payment, tax, delivery and policy settings in Shopify admin.
Paid gift wrapping
- Create a separate Shopify product representing your gift-wrapping service. Set the charge in that product's price field, for example TRY 50. Check its sales channel, inventory and availability settings. A single variant is the simplest setup.
- In theme settings →
Drawer gifts, select this product in the gift-wrap field (drawer_gift_wrap) and save. - Add a normal product to the cart. Confirm that gift wrapping displays its price and Add action. Choosing it adds a separate paid product line; it is not just a free note or checkbox.
- After adding wrapping through the theme, its Add button is disabled. Removing the wrapping line makes the option available again. This is not a server-side rule covering every external cart request.
- Change the fee by editing the same product's price. No theme code change is needed. The option is hidden when no product is selected or it is unavailable. A wrapping product with variants lets the shopper choose an available variant.
If the wrapping product requires a selling plan or has the requires-personalization tag, the theme links to its options rather than adding it directly. Tax, shipping and discounts follow Shopify's product settings. Incorrectly configuring a service as a shipped physical product can affect shipping calculations; configure it for your actual service.
The cart note and card message are separate fields. A card message alone does not create a Shopify gift card balance or code. An optional gift card product can be selected separately in drawer_gift_card; Shopify handles actual gift card operations.
Personalization and the candle designer
Add requires-personalization to products needing mandatory text. The theme form rejects blank text and avoids direct card actions that would skip these options. It does not provide server-side validation for external cart links.
Select a real product in the Candle designer section. Label text, colors, patterns and other design choices are submitted as line-item properties. The theme does not generate a print file or production job; your fulfillment team must read the order properties. Random variant selection requires the shopper's explicit opt-in. Subscription-only products use a link to the full product page. Products with very large variant catalogs can use option navigation; do not assume unsaved text survives that navigation.
Colors, content and motion
Brand settings include background, text, accent and accent foreground colors. If the chosen accent text has insufficient contrast, the theme falls back to a readable black or white foreground. Mood and featured collection blocks have separate light and dark foreground settings. Reward blocks also have a text color. Check every custom combination in both color modes.
Scrolling bands and automatic mood changes can be paused. Motion is reduced for shoppers requesting reduced motion. The pointer effect can be disabled in visual effects settings. Set candle burn duration from actual product data; the illustrative calculator is not a laboratory measurement.
Little Gesture selection guide
Open the product discovery section in the theme editor. Adjust its heading and description to your store language. Add up to 12 product blocks, selecting one product and one purpose per block: all purposes, a pause, a thank-you or a celebration. Products assigned to all purposes can appear for every purpose selection. If you select a product more than once, its first eligible block is shown; do not duplicate it to assign several purposes.
The shopper chooses a purpose and a maximum budget per product. Leaving the budget blank removes the price limit; zero can only match free products. A price equal to the budget is included. The displayed price, budget comparison and product link use the same selected or first available variant. This does not mean every variant of that product fits the budget. Shipping and gift wrapping are excluded and calculated separately in the cart.
The guide filters only available products selected in this section, rather than searching your full catalog. When nothing matches, shoppers can change their purpose or budget, or use Reset to return to the complete selection. Without JavaScript, the selected product links remain visible and the interactive controls stay hidden.
To check your setup, assign products to two different purposes, try a budget equal to a product's price and then a lower budget, and confirm Reset restores the selection. Also check unavailable products and variants in preview.
Search, filters and apps
Full collection and search filters use Shopify-provided filter data; configure your store's filters. The homepage interactive catalog filters only the displayed selection from its chosen collections, not the entire store. Keep the purchase block in the product template. Add app and Custom Liquid blocks as needed. Product review storage and subscriptions require their respective providers. App content in quick view is provider-dependent; use the full product page link when needed.
The promotion wheel starts disabled. To use it, configure 2–8 rewards with existing Shopify discount codes, add a terms link and enable the section. Codes are public storefront content, not secret or unique prizes. Manage eligibility, usage limits and combination rules in Shopify discounts. The browser cooldown is not a security boundary. Spinning is disabled in the theme editor.
Free-shipping messaging does not create a shipping rate; match its threshold and currency to your actual shipping rules. Instagram like counts are entered manually and do not synchronize automatically. The newsletter form does not set up an email campaign.
Launch checks and support
Use your own product to check variants, prices, required personalization, adding/removing wrapping, notes and checkout handoff. Check both color modes, mobile navigation and keyboard use. Measure your homepage, collection and product pages with Lighthouse on mobile and desktop; run each condition three times and compare the median result. A completed demo test order does not verify your own payment or app providers.
For support, provide the theme version, affected page, reproduction steps and a screenshot with personal data removed. Do not send passwords, API keys or customer payment details. Use the Lumerelle support form or email hello@simdigitallabs.com. The form supports English/Turkish and up to 3 optional screenshots totaling 2 MB. Support requests receive a response within two business days; the automatic acknowledgement is not the support reply. The theme has not been submitted to or approved by the Theme Store.
Kurulum ve ilk düzenleme
Yeni bir mağazaya kurarken temiz kurulum için Lumerelle-0.9.3-shopify.zip kullanın. Shopify temalar alanına ZIP'i ekleyin, önce önizlemede düzenleyin. Mevcut temayı değiştirmeden önce bir kopyasını alın. Demo ZIP'i örnek mağazanın ürün/koleksiyon seçimlerini içerir; başka mağazada bu kayıtlar otomatik oluşmaz. Tema paketi ürün, indirim, ödeme sağlayıcısı veya kargo tarifesi kurmaz.
Tema düzenleyicisinde marka logosu, favicon, yazı tipleri ve renkleri belirleyin. Header bölümünde kendi menünüzü seçin. Ana sayfadaki ruh hâli/koleksiyon kartları, ürün keşfi ve etiket tasarımcısında kendi ürün ve koleksiyonlarınızı seçin. Görselleri, örnek metinleri, altbilgi iletişim alanlarını ve menüleri kendi mağazanıza göre düzenleyin. Gerçek müşteri sözleri varsa yorum bloklarını ekleyin; örnek müşteri yorumu üretmeyin. Mağazanın ödeme, vergi, teslimat ve politika ayarlarını Shopify yönetiminden tamamlayın.
Ücretli hediye paketi
- Shopify ürünlerinde hediye paketleme hizmetini temsil eden ayrı bir ürün oluşturun. Ücreti bu ürünün fiyat alanına yazın; örneğin 50 TL. Normal ürün gibi satış kanalı, stok ve kullanılabilirlik ayarlarını kontrol edin. Tek varyant en sade kurulumdur.
- Tema ayarları → sepet hediyeleri (
Drawer gifts) → hediye paketi (drawer_gift_wrap) alanında bu ürünü seçin ve kaydedin. - Sepete normal bir ürün ekleyin. Sepette hediye paketinin fiyatını ve Ekle düğmesini kontrol edin. Seçim ayrı, ücretli bir ürün satırı olarak sepete girer; ücretsiz not veya yalnızca bir işaret kutusu değildir.
- Tema akışında paket eklendikten sonra tekrar ekleme düğmesi kapanır. Sepette paket satırını kaldırınca yeniden eklenebilir. Bu, mağazadaki bütün harici sepet isteklerine uygulanan sunucu kuralı değildir.
- Ücreti değiştirmek için aynı ürünün fiyatını değiştirin. Tema koduna fiyat yazmanız gerekmez. Ürün seçili değilse veya satışa uygun değilse seçenek gösterilmez. Varyantlı paket ürünlerinde müşteri kullanılabilir varyantı seçebilir.
Hediye paketi ürününe zorunlu abonelik veya requires-personalization etiketi verirseniz doğrudan ekleme yerine ürün seçeneklerine bağlantı gösterilir. Vergi, kargo ve indirim davranışı ürünün Shopify ayarlarına bağlıdır. Paket ürünü sepette taşınacak fiziksel bir ürün gibi yanlış yapılandırılırsa kargo hesabını etkileyebilir; kendi hizmet modelinize göre ayarlayın.
Sepet notu ve kart mesajı ayrı alanlardır. Kart mesajı alanı tek başına Shopify hediye kartı bakiyesi veya kodu oluşturmaz. İsteğe bağlı hediye kartı ürünü drawer_gift_card alanından ayrıca seçilir; gerçek hediye kartı işlemleri Shopify tarafından yürütülür.
Kişiselleştirme ve etiket tasarımcısı
Zorunlu metin isteyen ürüne requires-personalization etiketi ekleyin. Tema ürün formunda boş metinle eklemeyi engeller ve karttan seçenekleri atlayan doğrudan eklemeyi kullanmaz. Harici sepet bağlantıları için sunucu doğrulaması sağlamaz.
Candle designer bölümünde tasarlanacak gerçek ürünü seçin. Metin, renk, desen ve diğer tasarım seçimleri sipariş ürün özelliklerine aktarılır; baskı dosyası veya üretim işi otomatik oluşmaz. Üretim/paketleme ekibi bu özellikleri siparişten okumalıdır. Rastgele ürün varyantı, müşteri açıkça izin verdiğinde seçilir. Zorunlu abonelikli ürünler için tam ürün sayfası kullanılır. Çok yüksek varyantlı ürünlerde seçenek bağlantısıyla sayfa geçişi yapılabilir; geçişten önce girilmiş taslak metnin korunacağı varsayılmamalıdır.
Renkler, içerik ve hareket
Marka ayarlarında zemin, yazı, vurgu ve vurgu üzerindeki yazı rengini belirleyin. Vurgu yazısı yetersiz kontrast verirse tema siyah/beyaz okunabilir karşılığa geçer. Ruh hâli ve öne çıkan koleksiyon bloklarında açık/koyu mod yazı renklerini ayrı düzenleyin. Ödül bloklarının da kendi yazı rengi vardır. Tüm özel renk birleşimlerini açık ve koyu modda kontrol edin.
Kaydırılan şeritler ve otomatik ruh hâli geçişleri duraklatılabilir. Hareket azaltma tercihinde hareketler kısıtlanır. İmleç efekti görsel efektler ayarından kapatılır. Mum yanma hesaplayıcısının süresini gerçek ürün verisine göre girin; gösterim bir laboratuvar testi değildir.
Küçük Bir Jest seçim rehberi
Tema düzenleyicisinde ürün keşfi bölümünü açın. Başlık ve açıklamayı mağazanızın diline göre düzenleyin. En fazla 12 ürün bloğu ekleyin; her blokta bir ürün ve bir amaç seçin: tüm amaçlar, mola, teşekkür veya kutlama. Tüm amaçlara atanan ürünler her amaç seçiminde gösterilebilir. Aynı ürünü tekrar seçerseniz ilk uygun blok gösterilir; farklı amaçları aynı ürüne çoğaltarak atamayın.
Müşteri amacı ve ürün başına üst bütçesini seçer. Boş bütçe fiyat sınırı koymaz; sıfır bütçe yalnızca ücretsiz ürünleri gösterebilir. Eşit fiyat bütçeye dahildir. Gösterilen fiyat, bütçe karşılaştırması ve ürün bağlantısı aynı seçilmiş veya ilk kullanılabilir varyantı kullanır. Bu fiyat ürünün bütün varyantlarının bütçeye uyduğu anlamına gelmez. Kargo ve hediye paketi bütçeye dahil değildir; sepette ayrıca hesaplanır.
Rehber yalnızca bu bölümde seçtiğiniz satışa uygun ürünleri süzer; tüm mağaza kataloğunu taramaz. Eşleşme bulunmazsa müşteri amacını/bütçesini değiştirebilir veya Sıfırla ile tüm seçkilere dönebilir. JavaScript kapalıyken seçilmiş ürün bağlantıları görünür kalır; etkileşimli filtreler gösterilmez.
Kontrol için iki farklı amaca ürün atayın, bir ürünün fiyatına eşit bütçe ve daha düşük bütçe deneyin; ardından Sıfırla ile ürünlerin geri geldiğini doğrulayın. Kullanılamayan ürünleri ve varyantları önizlemede ayrıca kontrol edin.
Arama, filtreler ve uygulamalar
Tam koleksiyon/arama filtreleri Shopify'ın sağladığı filtre verisini kullanır; mağazanın filtre yapılandırmasını tamamlayın. Ana sayfadaki interaktif katalog yalnız seçili koleksiyonlardan gösterilen ürünleri filtreler; bütün mağaza araması değildir. Ürün düzenleyicisinde satın alma bloğunu koruyun; uygulama ve Özel Liquid bloklarını gerektiğinde ekleyin. Ürün yorumları ve abonelikler için ilgili sağlayıcı gerekir. Hızlı görünümde uygulama içeriği sağlayıcıya bağlıdır; tam ürün sayfası bağlantısını kullanın.
Promosyon çarkı başlangıçta kapalıdır. Kullanacaksanız Shopify'da mevcut indirim kodlarıyla 2–8 ödül tanımlayın, şartlar bağlantısını ekleyin ve bölümü etkinleştirin. Kodlar vitrinde görünür; benzersiz/gizli ödül sistemi değildir. Geçerlilik, kullanım sınırları ve birleştirme kuralları Shopify indirimlerinde yönetilir. Tarayıcı bekleme süresi güvenlik sınırı değildir. Düzenleyicide çark döndürülmez.
Ücretsiz kargo mesajı eşiği kargo tarifesi oluşturmaz; para birimi ve gerçek kargo kuralıyla eşleştirin. Instagram beğeni sayıları elle girilir; otomatik senkronizasyon yoktur. Bülten formu gönderimi bir e-posta kampanyası kurmaz.
Teslim öncesi kontrol ve destek
Kendi ürününüzle varyant/fiyat, zorunlu kişiselleştirme, hediye paketi ekleme-kaldırma, notlar ve ödeme geçişini deneyin. Açık/koyu mod, mobil menü ve klavyeyle kullanım kontrolü yapın. Lighthouse ile ana sayfa, koleksiyon ve ürün sayfasını mobil ve masaüstünde ölçün; her koşulu üç kez çalıştırıp ortanca sonucu karşılaştırın. Demo test siparişi doğrulanmış olsa da kendi ödeme/uygulama sağlayıcınız ayrıca denenmelidir.
Destek talebinde tema sürümünü, etkilenen sayfayı, tekrarlama adımlarını ve kişisel verileri gizlenmiş ekran görüntüsünü paylaşın. Şifre, API anahtarı veya müşteri ödeme bilgisi göndermeyin. Lumerelle destek formundan talep gönderebilir veya hello@simdigitallabs.com adresine yazabilirsiniz. Form Türkçe/İngilizce kullanılabilir; isteğe bağlı en fazla 3 ekran görüntüsü toplam 2 MB sınırıyla eklenebilir. Destek taleplerine iki iş günü içinde yanıt verilir; otomatik alındı mesajı destek yanıtı değildir. Theme Store başvurusu veya onayı henüz yoktur.