@behio/storefront-sdk 0.1.1 → 0.1.3

package/README.md

@@ -1,6 +1,26 @@
 # @behio/storefront-sdk
 
-TypeScript SDK for **Behio Headless E-Shop** — Storefront API client + React/Next.js hooks.
+**Build your own e-shop. Keep 100% control over the frontend.**
+
+Behio is a headless e-commerce platform that gives you a complete backend — products, inventory, orders, customers, discounts, multi-currency, multi-language, payments — and lets *you* design the storefront however you want. No themes, no templates, no vendor lock-in.
+
+This SDK is the fastest way to connect your Next.js, React, or any JavaScript app to the Behio Storefront API.
+
+## Why Behio?
+
+- **You own the frontend.** Build it in Next.js, Astro, Nuxt, SvelteKit, React Native — or use plain HTML. The backend doesn't care.
+- **Production-ready e-commerce backend in minutes.** Product catalog, cart, checkout, customer accounts, orders, tracking, CMS pages, discount codes, volume pricing, multi-warehouse inventory — all included.
+- **Built for developers.** Type-safe, auto-completing, fully documented. Modern React hooks with TanStack Query under the hood. Automatic token refresh, optimistic cart updates, SSR prefetch support.
+- **Scale-ready.** Redis caching, rate limiting, webhooks, API keys with scoped permissions. From MVP to millions of orders on the same stack.
+- **Admin UI you don't have to build.** Behio comes with a full admin dashboard for managing products, orders, customers, CMS content, and analytics. You focus on the customer experience.
+
+**Perfect for:**
+- Agencies building custom e-shops for clients
+- Brands that want their storefront to look and feel unique
+- SaaS apps that need built-in commerce
+- Headless migrations from Shopify, WooCommerce, PrestaShop
+
+## Get started
 
 ```bash
 npm install @behio/storefront-sdk
@@ -330,7 +350,7 @@ export function Providers({ children }: { children: React.ReactNode }) {
   return (
     <BehioProvider
       apiKey={process.env.NEXT_PUBLIC_BEHIO_API_KEY!}
-      baseUrl="/api"          // Next.js proxy to avoid CORS
+      baseUrl={process.env.NEXT_PUBLIC_BEHIO_API_URL}  // optional — defaults to https://api.behio.com
       locale="cs"
       currency="CZK"
       storage="cookies"       // "cookies" | "localStorage" | "memory"
@@ -356,7 +376,14 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 }
 ```
 
-Next.js rewrite in `next.config.ts`:
+```bash
+# .env.local
+NEXT_PUBLIC_BEHIO_API_KEY=pk_live_xxx
+NEXT_PUBLIC_BEHIO_API_URL=https://api.behio.com      # production
+# NEXT_PUBLIC_BEHIO_API_URL=http://localhost:7007    # local dev
+```
+
+**Optional:** If you prefer to hide the backend URL behind a proxy, add a Next.js rewrite in `next.config.ts` and set `baseUrl="/api"`:
 ```typescript
 async rewrites() {
   return [{ source: '/api/:path*', destination: 'https://api.behio.com/:path*' }];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",