create-magic-storefront 0.1.1 → 0.1.3

package/template/lib/i18n.ts

@@ -0,0 +1,315 @@
+import type { Schema } from '@magicstoreai/storefront-client';
+
+/**
+ * The storefront's own words, per language. Everything the merchant wrote (product titles,
+ * section titles, pages) comes translated from the API; only the interface is translated here.
+ * Server components pass `locale` from `lib/api.ts`, client components `useMagicStore().locale`.
+ */
+
+type OrderStatus = Schema<'Order'>['status'];
+
+function plural(
+  locale: string,
+  count: number,
+  forms: Partial<Record<Intl.LDMLPluralRule, string>> & { other: string },
+): string {
+  return forms[new Intl.PluralRules(locale).select(count)] ?? forms.other;
+}
+
+const en = {
+  // Navigation and shared
+  search: 'Search',
+  account: 'Account',
+  cart: 'Cart',
+  home: 'Home',
+  pages: 'Pages',
+  backToShop: 'Back to the shop',
+  continueShopping: 'Continue shopping',
+  seeAll: 'See all',
+  total: 'Total',
+  subtotal: 'Subtotal',
+  discount: 'Discount',
+  updating: 'Updating…',
+  // Errors
+  somethingWentWrong: 'Something went wrong',
+  tryAgainLater: 'Something went wrong. Please try again.',
+  tryAgain: 'Try again',
+  shopClosed: 'The shop is temporarily closed',
+  notFound: 'Page not found',
+  // Catalog
+  nothingHere: 'Nothing here yet.',
+  soldOut: 'Sold out',
+  preOrder: 'Pre-order',
+  sale: 'Sale',
+  isNew: 'New',
+  searchPlaceholder: 'What are you looking for?',
+  found: (count: number) => `${count} found`,
+  // Home sections
+  newArrivals: 'New arrivals',
+  onSale: 'On sale',
+  trending: 'Trending',
+  bestsellers: 'Bestsellers',
+  banner: 'Banner',
+  stockLeft: (remaining: number, initial: number) => `${remaining} of ${initial} left`,
+  endsAt: 'Ends',
+  customersSay: 'What our customers say',
+  reviewsCount: (count: number) =>
+    `${count} ${plural('en', count, { one: 'review', other: 'reviews' })}`,
+  recommendUs: (percent: number) => `${percent}% recommend us`,
+  leaveReview: 'Leave a review',
+  // Product
+  addToCart: 'Add to cart',
+  addedToCart: 'Added to cart.',
+  couldNotAdd: 'Could not add to cart.',
+  save: 'Save',
+  saved: 'Saved',
+  // Cart
+  cartEmpty: 'Your cart is empty',
+  loadingCart: 'Loading your cart…',
+  quantity: 'Quantity',
+  remove: 'Remove',
+  notAvailable: 'Not available any more',
+  discountCode: 'Discount code',
+  apply: 'Apply',
+  codeApplied: 'applied',
+  codeNotApplied: 'not applied',
+  checkout: 'Checkout',
+  // Checkout
+  checkoutTitle: 'Checkout',
+  preparingCheckout: 'Preparing checkout…',
+  contact: 'Contact',
+  name: 'Name',
+  phone: 'Phone',
+  saveContact: 'Save contact',
+  delivery: 'Delivery',
+  pickUp: 'Pick up',
+  orDeliverTo: 'Or deliver to',
+  deliverTo: 'Deliver to',
+  street: 'Street, house',
+  city: 'City',
+  latitude: 'Latitude',
+  longitude: 'Longitude',
+  useMyLocation: 'Use my location',
+  showDeliveryOptions: 'Show delivery options',
+  free: 'free',
+  payment: 'Payment',
+  placeOrder: 'Place order',
+  thankYou: 'Thank you!',
+  order: 'Order',
+  payNow: 'Pay now',
+  // Account
+  signIn: 'Sign in',
+  sendCode: 'Send code',
+  smsCode: 'Code from the SMS',
+  signOut: 'Sign out',
+  orders: 'Orders',
+  loadingOrders: 'Loading orders…',
+  noOrders: 'No orders yet.',
+  savedProducts: 'Saved products',
+  orderStatus: {
+    NEW: 'New',
+    ACCEPTED: 'Accepted',
+    PROCESSED: 'Processing',
+    ASSEMBLED: 'Packed',
+    DELIVERING: 'On the way',
+    DELIVERED: 'Delivered',
+    CANCELLED: 'Cancelled',
+  } satisfies Record<OrderStatus, string>,
+};
+
+export type Messages = typeof en;
+
+const ru: Messages = {
+  search: 'Поиск',
+  account: 'Кабинет',
+  cart: 'Корзина',
+  home: 'Главная',
+  pages: 'Страницы',
+  backToShop: 'Вернуться в магазин',
+  continueShopping: 'Продолжить покупки',
+  seeAll: 'Смотреть все',
+  total: 'Итого',
+  subtotal: 'Товары',
+  discount: 'Скидка',
+  updating: 'Обновляем…',
+  somethingWentWrong: 'Что-то пошло не так',
+  tryAgainLater: 'Что-то пошло не так. Попробуйте ещё раз.',
+  tryAgain: 'Попробовать снова',
+  shopClosed: 'Магазин временно закрыт',
+  notFound: 'Страница не найдена',
+  nothingHere: 'Здесь пока ничего нет.',
+  soldOut: 'Нет в наличии',
+  preOrder: 'Предзаказ',
+  sale: 'Скидка',
+  isNew: 'Новинка',
+  searchPlaceholder: 'Что вы ищете?',
+  found: (count) => `Найдено: ${count}`,
+  newArrivals: 'Новинки',
+  onSale: 'Со скидкой',
+  trending: 'Популярное',
+  bestsellers: 'Хиты продаж',
+  banner: 'Баннер',
+  stockLeft: (remaining, initial) => `Осталось ${remaining} из ${initial}`,
+  endsAt: 'Закончится',
+  customersSay: 'Что говорят покупатели',
+  reviewsCount: (count) =>
+    `${count} ${plural('ru', count, { one: 'отзыв', few: 'отзыва', other: 'отзывов' })}`,
+  recommendUs: (percent) => `${percent}% рекомендуют нас`,
+  leaveReview: 'Оставить отзыв',
+  addToCart: 'В корзину',
+  addedToCart: 'Добавлено в корзину.',
+  couldNotAdd: 'Не удалось добавить в корзину.',
+  save: 'В избранное',
+  saved: 'В избранном',
+  cartEmpty: 'Корзина пуста',
+  loadingCart: 'Загружаем корзину…',
+  quantity: 'Количество',
+  remove: 'Удалить',
+  notAvailable: 'Больше недоступен',
+  discountCode: 'Промокод',
+  apply: 'Применить',
+  codeApplied: 'применён',
+  codeNotApplied: 'не применён',
+  checkout: 'Оформить заказ',
+  checkoutTitle: 'Оформление заказа',
+  preparingCheckout: 'Готовим оформление…',
+  contact: 'Контакты',
+  name: 'Имя',
+  phone: 'Телефон',
+  saveContact: 'Сохранить контакты',
+  delivery: 'Доставка',
+  pickUp: 'Самовывоз',
+  orDeliverTo: 'Или доставка по адресу',
+  deliverTo: 'Доставка по адресу',
+  street: 'Улица, дом',
+  city: 'Город',
+  latitude: 'Широта',
+  longitude: 'Долгота',
+  useMyLocation: 'Моё местоположение',
+  showDeliveryOptions: 'Показать способы доставки',
+  free: 'бесплатно',
+  payment: 'Оплата',
+  placeOrder: 'Подтвердить заказ',
+  thankYou: 'Спасибо!',
+  order: 'Заказ',
+  payNow: 'Оплатить',
+  signIn: 'Войти',
+  sendCode: 'Получить код',
+  smsCode: 'Код из SMS',
+  signOut: 'Выйти',
+  orders: 'Заказы',
+  loadingOrders: 'Загружаем заказы…',
+  noOrders: 'Заказов пока нет.',
+  savedProducts: 'Избранное',
+  orderStatus: {
+    NEW: 'Новый',
+    ACCEPTED: 'Принят',
+    PROCESSED: 'В обработке',
+    ASSEMBLED: 'Собран',
+    DELIVERING: 'В пути',
+    DELIVERED: 'Доставлен',
+    CANCELLED: 'Отменён',
+  },
+};
+
+const uz: Messages = {
+  search: 'Qidiruv',
+  account: 'Kabinet',
+  cart: 'Savat',
+  home: 'Bosh sahifa',
+  pages: 'Sahifalar',
+  backToShop: "Do'konga qaytish",
+  continueShopping: 'Xaridni davom ettirish',
+  seeAll: 'Barchasi',
+  total: 'Jami',
+  subtotal: 'Mahsulotlar',
+  discount: 'Chegirma',
+  updating: 'Yangilanmoqda…',
+  somethingWentWrong: 'Nimadir xato ketdi',
+  tryAgainLater: "Nimadir xato ketdi. Qaytadan urinib ko'ring.",
+  tryAgain: 'Qayta urinish',
+  shopClosed: "Do'kon vaqtincha yopiq",
+  notFound: 'Sahifa topilmadi',
+  nothingHere: "Hozircha bu yerda hech narsa yo'q.",
+  soldOut: "Sotuvda yo'q",
+  preOrder: 'Oldindan buyurtma',
+  sale: 'Chegirma',
+  isNew: 'Yangi',
+  searchPlaceholder: 'Nima qidiryapsiz?',
+  found: (count) => `${count} ta topildi`,
+  newArrivals: 'Yangi kelganlar',
+  onSale: 'Chegirmadagilar',
+  trending: 'Ommabop',
+  bestsellers: 'Xitlar',
+  banner: 'Banner',
+  stockLeft: (remaining, initial) => `${initial} tadan ${remaining} ta qoldi`,
+  endsAt: 'Tugaydi',
+  customersSay: 'Mijozlarimiz fikri',
+  reviewsCount: (count) => `${count} ta sharh`,
+  recommendUs: (percent) => `${percent}% bizni tavsiya qiladi`,
+  leaveReview: 'Sharh qoldirish',
+  addToCart: "Savatga qo'shish",
+  addedToCart: "Savatga qo'shildi.",
+  couldNotAdd: "Savatga qo'shib bo'lmadi.",
+  save: 'Saqlash',
+  saved: 'Saqlangan',
+  cartEmpty: "Savatingiz bo'sh",
+  loadingCart: 'Savat yuklanmoqda…',
+  quantity: 'Soni',
+  remove: "O'chirish",
+  notAvailable: 'Endi mavjud emas',
+  discountCode: 'Promokod',
+  apply: "Qo'llash",
+  codeApplied: "qo'llanildi",
+  codeNotApplied: "qo'llanilmadi",
+  checkout: 'Rasmiylashtirish',
+  checkoutTitle: 'Buyurtmani rasmiylashtirish',
+  preparingCheckout: 'Tayyorlanmoqda…',
+  contact: "Bog'lanish",
+  name: 'Ism',
+  phone: 'Telefon',
+  saveContact: 'Saqlash',
+  delivery: 'Yetkazib berish',
+  pickUp: 'Olib ketish',
+  orDeliverTo: 'Yoki manzilga yetkazish',
+  deliverTo: 'Manzilga yetkazish',
+  street: "Ko'cha, uy",
+  city: 'Shahar',
+  latitude: 'Kenglik',
+  longitude: 'Uzunlik',
+  useMyLocation: 'Joylashuvimni aniqlash',
+  showDeliveryOptions: "Yetkazib berish usullarini ko'rsatish",
+  free: 'bepul',
+  payment: "To'lov",
+  placeOrder: 'Buyurtmani tasdiqlash',
+  thankYou: 'Rahmat!',
+  order: 'Buyurtma',
+  payNow: "To'lash",
+  signIn: 'Kirish',
+  sendCode: 'Kod olish',
+  smsCode: 'SMS dagi kod',
+  signOut: 'Chiqish',
+  orders: 'Buyurtmalar',
+  loadingOrders: 'Buyurtmalar yuklanmoqda…',
+  noOrders: "Hozircha buyurtmalar yo'q.",
+  savedProducts: 'Saqlanganlar',
+  orderStatus: {
+    NEW: 'Yangi',
+    ACCEPTED: 'Qabul qilindi',
+    PROCESSED: 'Ishlov berilmoqda',
+    ASSEMBLED: "Yig'ildi",
+    DELIVERING: 'Yetkazilmoqda',
+    DELIVERED: 'Yetkazildi',
+    CANCELLED: 'Bekor qilindi',
+  },
+};
+
+export const MESSAGES = { en, ru, uz } as const;
+
+/** The dictionary for a locale (`ru`, `ru-RU`, `uz-Latn-UZ`…); English when there is none. */
+export function messages(locale: string): Messages {
+  const language = locale.toLowerCase().split('-')[0];
+  return language !== undefined && Object.hasOwn(MESSAGES, language)
+    ? MESSAGES[language as keyof typeof MESSAGES]
+    : MESSAGES.en;
+}

package/template/llms.txt

@@ -24,15 +24,15 @@ call the client method. `npx create-magic-storefront check` fails on either.
 npm create magic-storefront@latest my-shop -- --shop shop.example.uz
 ```
 
-scaffolds a Next.js App Router storefront (home from the merchant's sections, catalog, product,
-search, cart, checkout, sign-in, orders, SEO, webhook revalidation). Or install the packages:
+scaffolds a Next.js App Router storefront (home from the merchant's sections or your own, catalog,
+product, search, cart, checkout, sign-in, orders, SEO, webhook revalidation). Or install the packages:
 `npm i @magicstoreai/storefront-client @magicstoreai/hydrogen`.
 
 ## Docs
 
 - `PAGES.md` (in a scaffolded storefront; `examples/starter/PAGES.md` in the SDK repository): how to
-  build each page type — home from the `/home` sections, collection, product, search, cart,
-  checkout, account — with its data calls, cache tags, SEO and required states.
+  build each page type — home (from the `/home` sections or custom), collection, product, search,
+  cart, checkout, account — with its data calls, cache tags, SEO and required states.
 - [Hydrogen catalogue](node_modules/@magicstoreai/hydrogen/CATALOGUE.md): every export with its props
   or signature, an example, and the API operations it calls. In the SDK repository:
   `packages/hydrogen/CATALOGUE.md`.
@@ -65,8 +65,10 @@ Public catalog reads need no customer. Render them on the server with a client w
 - Lists paginate with `page` + `perPage` (default 24, max 100); read `meta.pagination`, or
   `<Pagination>`. Sorts order (`sort=-createdAt`), filters narrow (`filter[onSale]=true`).
 - A missing value is `null`, never `0` or `""`: show a fallback.
-- The home page is `GET /home`: an ordered list of sections, one `type` each
-  (`GET /theme/section-schema` has every type's JSON Schema). Render an unknown type as nothing.
+- The home page is yours to design. `GET /home` (an ordered list of sections, one `type` each;
+  `GET /theme/section-schema` has every type's JSON Schema) is optional: render it to let the
+  merchant arrange the page from the admin, or compose a custom home from catalog and content
+  data. When you render it, an unknown type renders as nothing.
 
 ## Credentials in the browser