{"_id":"@bagisto-native/about","_rev":"2-cf2a68a20dd6f93fd24b2ed3e1b295be","name":"@bagisto-native/about","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@bagisto-native/about","version":"1.0.0","license":"MIT","_id":"@bagisto-native/about@1.0.0","maintainers":[{"name":"anikesh-kumar","email":"anikesh.dsvv@gmail.com"}],"dist":{"shasum":"fb0657d63a11556b774f43e1d309bedb8671a37f","tarball":"https://registry.npmjs.org/@bagisto-native/about/-/about-1.0.0.tgz","fileCount":2,"integrity":"sha512-Llx+PTDedhDR8fVWfQC8oSPBFjNDpc7xrqmY+oCYSwFeqJc220NdIEWryyU0euzm75CdzqVDgjIA59E5dk1+8A==","signatures":[{"sig":"MEQCIHpGXLE6ogabNMisjkWctTDhSoqpOLtJt6OeWYZdZ4FBAiBmN8xWFIqtWUBxsOwbqpiuY2dfLIJTdy7crqzCK0wqsQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5774},"private":false,"_npmUser":{"name":"anikesh-kumar","email":"anikesh.dsvv@gmail.com"},"_npmVersion":"11.4.2","description":"Bagisto Native Framework enables application to run inside fully native iOS/Android app","directories":{},"_nodeVersion":"20.18.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/about_1.0.0_1767192961675_0.8226164974241861","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bagisto-native/about","version":"1.0.1","description":"Bagisto Native Framework enables application to run inside fully native iOS/Android app","keywords":["bagisto-headless-commerce","open-source-headless-ecommerce","web-to-mobile-app","headless-commerce","ios","android","nextjs","react","api-first"],"license":"MIT","private":false,"author":{"name":"Bagisto"},"_id":"@bagisto-native/about@1.0.1","_nodeVersion":"20.18.3","_npmVersion":"11.4.2","dist":{"integrity":"sha512-BvnKW2qO0a24vYZpUANGIS3BC/7Fk5kGhPaHzEdmIgs437Z4zV9qvUCa71Swea6R6M0EN8yaRJz3WobPv4rNSg==","shasum":"87bc4b139410dc5ec368dfd467c0ffa4b70d0197","tarball":"https://registry.npmjs.org/@bagisto-native/about/-/about-1.0.1.tgz","fileCount":2,"unpackedSize":6050,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICj2fQcr8d4bxw/t1r/dPv/nl4XyXEwHyUY1DtextIRaAiBYJ60ICaLA4OjcxqUPINkWoN/Y+zuQhQiNAQmWR9uWGw=="}]},"_npmUser":{"name":"anikesh-kumar","email":"anikesh.dsvv@gmail.com"},"directories":{},"maintainers":[{"name":"anikesh-kumar","email":"anikesh.dsvv@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/about_1.0.1_1767193362398_0.47882902009397"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-31T14:56:01.554Z","modified":"2025-12-31T15:02:42.745Z","1.0.0":"2025-12-31T14:56:01.829Z","1.0.1":"2025-12-31T15:02:42.537Z"},"license":"MIT","description":"Bagisto Native Framework enables application to run inside fully native iOS/Android app","maintainers":[{"name":"anikesh-kumar","email":"anikesh.dsvv@gmail.com"}],"readme":"# Bagisto Native\n\nBagisto Native is an ecosystem of headless, mobile-first tools that enables any React or Next.js application to seamlessly work with native mobile apps, modern frontend frameworks, and API-driven architectures.\n\nIt is **officially optimized for [Bagisto Headless eCommerce](https://bagisto.com/en/headless-ecommerce/)**, while remaining flexible enough to integrate with any API-driven or headless backend.\n\n\n## 🚀 What We Focus On\n\n- 📱 Native-first commerce experiences\n- 🌐 Headless & API-driven Bagisto\n- ⚡ Modern frontend stacks (Next.js, React, Turbo)\n- 🔌 Mobile bridges & integrations\n- 🧩 Reusable SDKs & utilities\n\n\n## 📦 Packages\n\n| Package | Description |\n|------|------------|\n| [@bagisto-native/core](https://www.npmjs.com/package/@bagisto-native/core) | Core utilities and shared logic |\n| [@bagisto-native/react](https://www.npmjs.com/package/@bagisto-native/react) | React wrappers for the Web Components included in your projects |\n\n## Getting Started\n\nThis guide shows how to build a **fully native mobile application** using the **Bagisto Native Framework**.\n\nBy following it, you’ll be able to create a production-ready native app step by step.\n\n\n## Architecture Overview\n\n<div align=\"center\">\n\n<pre>\n┌──────────────────────────────┐\n│      Bagisto Backend         │\n│     (Laravel + APIs)         │\n└─────────────▲────────────────┘\n              │\n              │ REST / GraphQL\n              │\n┌─────────────┴────────────────┐\n│      Bagisto Headless        │\n│  ┌─────────────────────────┐ │\n│  │ @bagisto-native/core    │ │\n│  │ @bagisto-native/react   │ │\n│  └─────────────────────────┘ │\n└─────────────▲────────────────┘\n              │\n              │ Native Bridge\n              │\n┌─────────────┴────────────────┐\n│     Bagisto Native App       │\n│   (Swift/Android + WebView)  │\n└──────────────────────────────┘\n</pre>\n\n</div>\n\n\n## 📋 Prerequisites\n\nBefore starting, ensure you have:\n\n- Node.js (LTS recommended)\n- PHP & Composer (for Bagisto backend)\n- Xcode (latest stable version)\n- macOS system\n\n---\n\n## 🛠️ Step 1: Create Bagisto Headless Commerce\n\nBagisto Headless acts as the API layer between your Bagisto backend and native apps.\n\n### Create Headless Storefront\n\n> **Note:** To create **Bagisto Headless Commerce**, use the following command:\n\n```bash\nnpx -y @bagisto-headless/create your-storefront\n```\n\n### Repository Reference\n\nBagisto Headless Repository: https://github.com/bagisto/nextjs-commerce\n\n\n## ⚙️ Step 2: Configure & Run Bagisto Headless\n\nNavigate to the generated project:\n\n```bash\ncd your-storefront\n```\n\nInstall dependencies, configure the .env file, and start the development server:\n\n```bash\nnpm install\nnpm run dev\n```\n\n## 🔗 Step 3: Integrate Bagisto Native Framework\n\nTo enable native app communication, you must integrate the **Bagisto Native Framework**\ninside your **Bagisto Headless (Next.js)** project.\n\nThis step is **mandatory** before setting up the native application.\n\n### What this step includes\n\n- Installing:\n  - [**@bagisto-native/core**](https://www.npmjs.com/package/@bagisto-native/core)\n\n  ```bash  \n   npm install @bagisto-native/core\n  ```\n\n  - [**@bagisto-native/react**](https://www.npmjs.com/package/@bagisto-native/react)\n\n  ```bash  \n   npm install @bagisto-native/react\n  ```\n\n- Adding the Hotwire `bundle.js`\n- Registering required Hotwire bridge components\n- Wiring native events (toast, navigation, cart, search, etc.)\n\n📘 **Follow the official Bagisto Native Framework documentation**  \nRefer to the root `README.md` of the Bagisto Native Framework and complete **all integration steps** inside your Bagisto Headless Next.js project.\n\n> Once this step is complete, your web application becomes **native-ready**\n> and can be safely loaded inside the Bagisto Native app.\n\n\n## 🌐 Step 4: Determine Your Project URL\n\nYour native application will communicate with Bagisto Headless using a **Project URL**.\n\n> ⚠️ Ensure your device or simulator is on the same network.\n\n\n## Step 5: Set Up Bagisto Native iOS app\n\n### Clone the iOS Repository\n\n```bash\ngit clone https://github.com/SocialMobikul/BagistoNative_iOS.git\ncd BagistoNative_iOS\n```\n\nRepository reference:  \nhttps://github.com/SocialMobikul/BagistoNative_iOS\n\n\n### 🧩 Open Project in Xcode\n\n```bash\nopen BagistoNative.xcodeproj\n```\n\n\n## 🔧 Step 6: Configure Base URL in iOS App\n\nInside the iOS project:\n\n```swift\nlet base_url = \"https://your-headless-base-url\"\n```\n\nExample:\n\n```swift\nlet base_url = \"https://your-storefront.vercel.app\"\n```\n\nUpdate the base_url value with your **Project Url**.\n\n\n## 🚀 Step 7: Build & Run the iOS Application\n\n1. Select a simulator or connected iPhone\n2. Click **Run** in Xcode\n3. Verify products, cart, checkout, and API connectivity\n\n\n## Congratulations\n\nYour **Bagisto Native application** is now ready.\n\n\n## 🔗 Helpful Resources\n\n- Bagisto Headless: https://github.com/bagisto/nextjs-commerce\n- Bagisto Native iOS: https://github.com/SocialMobikul/BagistoNative_iOS\n","readmeFilename":"README.md","keywords":["bagisto-headless-commerce","open-source-headless-ecommerce","web-to-mobile-app","headless-commerce","ios","android","nextjs","react","api-first"],"author":{"name":"Bagisto"}}