MarketX is a state-of-the-art decentralized marketplace built on the Stellar Network. It leverages Soroban Smart Contracts to ensure trustless transactions through a secure escrow system, providing total peace of mind for both buyers and sellers.
- 🛡️ Escrow Protection: Funds are locked in smart contracts and only released upon successful delivery.
- 🌐 Stellar Native: Built for the Stellar ecosystem, featuring low fees and lightning-fast settlements.
- 🔑 Hybrid Auth: Seamlessly switch between Web2 (JWT-based) and Web3 (Freighter Wallet) authentication.
- ✨ Premium UI/UX: High-end dark mode aesthetic with glassmorphism, Framer Motion animations, and a responsive design.
- 🛠️ Role-Based Access: Dedicated workflows for Buyers and Sellers.
- Framework: Next.js 15 (App Router)
- Runtime: React 19
- Styling: Tailwind CSS v4
- Animations: Framer Motion
- Web3: @stellar/freighter-api
- Data Fetching: @tanstack/react-query
- Icons: Lucide React
- Node.js 20+
- Stellar Freighter Wallet extension installed in your browser.
-
Clone the repository:
git clone [email protected]:MarketXpress/MarketX-frontend.git cd MarketX-frontend
-
Install dependencies:
npm install
-
Run the development server:
npm run dev
-
Build for production:
npm run build
src/app: Next.js App Router pages and layouts.src/components: Reusable UI and layout components.src/components/animations: Framer Motion animation primitives.src/components/auth: Wallet connection and auth-related components.
src/context: React Context providers (Auth, etc.).src/providers: External library providers (React Query).src/lib: Utility functions and configuration.
This is an open-source project and we welcome contributions! Whether it's fixing a bug, adding a feature, or improving documentation, feel free to open a Pull Request.
- Create a new branch:
git checkout -b feat/your-feature-name - Commit your changes:
git commit -m "feat: your feature description" - Push to the branch:
git push origin feat/your-feature-name - Open a Pull Request.
Distributed under the MIT License. See LICENSE for more information.
Built with ❤️ by the MarketX Laboratory team.