{"id":18780541,"url":"https://github.com/barkprotocol/ecommerce-platform","last_synced_at":"2026-05-07T09:35:17.798Z","repository":{"id":252397927,"uuid":"839703228","full_name":"barkprotocol/ecommerce-platform","owner":"barkprotocol","description":"BARK | Commerce is an innovative, headless e-Commerce platform that leverages the power of MedusaJS, Solana blockchain, and USDC stablecoin. Designed for modern businesses, BARK Protocol offers a decentralized, scalable, and flexible solution for all your eCommerce needs.","archived":false,"fork":false,"pushed_at":"2024-10-02T06:19:03.000Z","size":1307,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-27T04:37:48.816Z","etag":null,"topics":["headless-commerce","medusajs","nextjs","solana","solanapay"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/barkprotocol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-08T06:51:37.000Z","updated_at":"2024-10-02T06:19:06.000Z","dependencies_parsed_at":"2024-11-07T20:42:08.242Z","dependency_job_id":null,"html_url":"https://github.com/barkprotocol/ecommerce-platform","commit_stats":null,"previous_names":["barkprotocol/ecommerce-platform"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/barkprotocol/ecommerce-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkprotocol%2Fecommerce-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkprotocol%2Fecommerce-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkprotocol%2Fecommerce-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkprotocol%2Fecommerce-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/barkprotocol","download_url":"https://codeload.github.com/barkprotocol/ecommerce-platform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkprotocol%2Fecommerce-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32731724,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["headless-commerce","medusajs","nextjs","solana","solanapay"],"created_at":"2024-11-07T20:27:00.803Z","updated_at":"2026-05-07T09:35:17.780Z","avatar_url":"https://github.com/barkprotocol.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.barkprotocol.com\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://ucarecdn.com/74392932-2ff5-4237-a1fa-e0fd15725ecc/bark_dark.svg\"\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://ucarecdn.com/74392932-2ff5-4237-a1fa-e0fd15725ecc/bark_light.svg\"\u003e\n      \u003cimg alt=\"BARK logo\" src=\"https://ucarecdn.com/74392932-2ff5-4237-a1fa-e0fd15725ecc/bark.svg\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\n  BARK: A Headless e-Commerce Platform Monorepo\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e\n  \u003ca href=\"https://commerce-docs.barkprotocol.net\"\u003eDocumentation\u003c/a\u003e | (Under construction)\n  \u003ca href=\"https://www.barkprotocol.com\"\u003eOfficial Website\u003c/a\u003e |\n  \u003ca href=\"https://github.com/barkprotocol/medusa--bark-payment-plugin/\"\u003eWe3 Payments Plugins\u003c/a\u003e | (Under construction)\n\u003c/h4\u003e\n\nBARK | Commerce is an innovative, headless e-Commerce platform that leverages the power of MedusaJS, Solana blockchain, and USDC stablecoin. Designed for modern businesses, BARK Protocol offers a decentralized, scalable, and flexible solution for all your eCommerce needs. The platform integrates seamlessly with modern technologies to provide a robust, customizable, and future-proof solution for online retailers. With its decentralized structure and powerful integrations, BARK Protocol ensures your business stays ahead in the ever-evolving digital marketplace.\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Project Structure](#project-structure)\n- [Getting Started](#getting-started)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Usage](#usage)\n- [Integration Details](#integration-details)\n  - [Solana Integration](#solana-integration)\n  - [BARK Integration](#solana-integration)\n  - [USDC Integration](#usdc-integration)\n- [References](#references)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Introduction\n\nThe BARK eCommerce platform is built on the robust MedusaJS framework, providing a seamless headless eCommerce experience that emphasizes speed, flexibility, and cutting-edge blockchain technology. By integrating Solana for lightning-fast transactions and USDC for stable payments, BARK offers a reliable and future-proof solution for online retailers.\n\n## Features\n\n- **Headless Architecture:** A decoupled front-end and back-end structure for maximum flexibility and customization, allowing seamless integration with various front-end frameworks.\n- **Solana Blockchain Support:** Leverage Solana's high-speed and low-cost transaction capabilities for efficient payment processing, ensuring quick and secure transactions.\n- **Solana Payment Gateway \u0026 Plugin:** Utilize SOL, BARK, and USDC stablecoin to minimize currency volatility and ensure stable transactions, offering a reliable payment method for customers.\n- **Customizable and Scalable:** Adapt the platform to fit your specific business requirements and scale effortlessly as you grow, providing a tailored solution for various industries.\n- **Decentralized Solutions:** Enhance security and transparency through the power of blockchain technology, providing peace of mind for you and your customers by ensuring data integrity and protection.\n\n### Features include:\n\n- **Full e-commerce support:**\n\n  - Product Detail Page\n  - Product Overview Page\n  - QR code payments features\n  - Search with Algolia / MeiliSearch\n  - Product Collections\n  - Cart\n  - Checkout with PayPal, Solana Pay, and Stripe\n  - Web3 payment gateways\n  - User Accounts\n  - Order Details\n\n- **Full Next.js 14 support:**\n  - App Router\n  - Next fetching/caching\n  - Server Components\n  - Server Actions\n  - Streaming\n  - Static Pre-Rendering\n\n## Project Structure\n\nThe project is divided into two main folders:\n\n### 1. **Storefront**\n\nThis folder contains the front-end components of the platform. Built with Next.js, it manages the user-facing storefront where customers can browse products, add them to the cart, and complete transactions.\n\n- **Next.js:** For server-side rendering and static site generation.\n- **Tailwind CSS:** For styling and responsive design.\n- **State Management:** Uses React context for handling state.\n  \n**Storefront directory structure:**\n- `pages/`: All Next.js routes and components.\n- `components/`: Reusable UI components for the storefront.\n- `lib/`: Utilities and helper functions for front-end operations.\n- `styles/`: Tailwind configuration and custom styles.\n\n### 2. **Backend**\n\nThis folder includes the back-end logic and API handling. It powers the headless architecture of BARK, connecting to MedusaJS, Solana, and USDC.\n\n- **MedusaJS:** For the core eCommerce functionality.\n- **PostgreSQL:** The database used for storing product data and order details.\n- **Solana \u0026 USDC Integrations:** Handles blockchain payments and transactions.\n\n**Backend directory structure:**\n- `server/`: The core back-end logic, including APIs.\n- `services/`: MedusaJS services that manage the business logic.\n- `database/`: PostgreSQL configuration and migration files.\n- `config/`: API keys and environment configuration files.\n\n### 3. Web3 Payment Gateway\n\n- **BARK Payment Plugin**:\n  - **Seamless Integration**: Easily integrates with your existing MedusaJS setup to enable Web3 payments.\n  - **Multi-Currency Support**: Accept payments in SOL, BARK, and USDC stablecoin, providing customers with flexible payment options.\n  - **Low Transaction Fees**: Leverage the low-cost transaction capabilities of the Solana blockchain for economical payment processing.\n\n**Payment Plugin Directory Structure:**\n  - `src/`: Contains the source code for the web3 payment plugin.\n  - `components/`: UI components related to payment processing.\n  - `services/`: Functions for handling payment transactions and interactions with the Solana blockchain.\n  - `utils/`: Utility functions for managing payment data and API interactions.\n  - `config/`: Configuration files for setting up the plugin and API keys.\n  - `index.ts`: Entry point for the payment plugin, exporting the main functionalities.\n\n## Getting Started\n\nVisit the [Quickstart Guide](https://docs.medusajs.com/create-medusa-app) to set up a server.\n\nTo get your development environment ready and start using BARK Commerce, follow these steps.\n\n### Prerequisites\n\n- **Node.js:** v18.x or later\n- **PostgreSQL:** A reliable database solution for storing application data\n- **Yarn or npm:** Your preferred package manager\n\n### Installation\n\n1. **Clone the Repository:**\n\n   ```bash\n   git clone https://github.com/barkprotocol/e-commerce-platform.git\n   cd backend\n   ```\n\n2. **Install Dependencies:**\n\n   ```bash\n   yarn install\n   ```\n\n   or\n\n   ```bash\n   pnpm install\n   ```\n\n3. **Set Up the Database:**\n\n   Configure your PostgreSQL database and update the environment variables accordingly.\n\n### Configuration\n\n1. **Environment Variables:**\n\n   Create a `.env` file and configure it with your database and API keys:\n\n   ```\n   DATABASE_URL=postgresql://username:password@host:port/database\n   SOLANA_API_KEY=your_solana_api_key\n   BARK_PAY_API_KEY=your_bark_pay_api_key\n   USDC_API_KEY=your_usdc_api_key  # Circle API key\n   ```\n\n2. **Configure Medusa:**\n\n   Ensure MedusaJS is properly set up to handle headless operations by following the [MedusaJS setup guide](https://docs.medusajs.com/development/overview).\n\n## Usage\n\nStart the development server:\n\n```bash\nyarn start\n```\n\nor\n\n```bash\npnpm start\n```\n\nThis will launch the server, and you can access your eCommerce platform locally at `http://localhost:YOUR_PORT`.\n\n## Integration Details\n\n### Solana Integration\n\nBARK utilizes the Solana blockchain to provide fast and cost-effective transactions. Make sure your Solana API key is correctly configured in your `.env` file. For more information, refer to the [Solana documentation](https://docs.solanalabs.com/).\n\n### BARK Integration\n\nThe BARK payment gateway enables BARK token transactions, reducing volatility risks. Ensure your API configuration is correct in the `.env` file. More details can be found in the [BARK Protocol documentation](https://).\n\n### USDC Integration\n\nThe USDC payment gateway enables stablecoin transactions, reducing volatility risks. Ensure your API configuration is correct in the `.env` file. More details can be found in the [Circle documentation](https://circle.com/en/).\n\n## References\n\n- [MedusaJS Documentation](https://docs.medusajs.com/development/overview)\n- [Circle Documentation](https://circle.com/en/)\n- [Solana Documentation](https://docs.solanalabs.com/)\n- [Solana Pay Documentation](https://solanapay.com/)\n\n## Contributing\n\nContributions are welcome and appreciated. Please follow the steps below to contribute to BARK:\n\n1. Fork the repository.\n2. Create a new feature branch (`git checkout -b feature/YourFeature`).\n3. Commit your changes (`git commit -m 'Add a cool feature'`).\n4. Push to the branch (`git push origin feature/YourFeature`).\n5. Open a pull request.\n\nFor more detailed guidelines, please refer to the `CONTRIBUTING.md` file.\n\n## License\n\nThe MIT License. See the `LICENSE` file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarkprotocol%2Fecommerce-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbarkprotocol%2Fecommerce-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarkprotocol%2Fecommerce-platform/lists"}