{"id":26256383,"url":"https://github.com/juliusmarkwei/x-commerce","last_synced_at":"2026-04-16T05:31:26.130Z","repository":{"id":281837717,"uuid":"946552304","full_name":"juliusmarkwei/x-commerce","owner":"juliusmarkwei","description":"ICEO inspired Ecommerce UI","archived":false,"fork":false,"pushed_at":"2025-03-11T11:39:04.000Z","size":3170,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-02T13:52:44.808Z","etag":null,"topics":["ecommerce","nextjs","redux","scss","ui"],"latest_commit_sha":null,"homepage":"https://x-commerce-three.vercel.app","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/juliusmarkwei.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2025-03-11T10:16:17.000Z","updated_at":"2025-03-11T11:44:10.000Z","dependencies_parsed_at":"2025-03-11T12:40:55.155Z","dependency_job_id":null,"html_url":"https://github.com/juliusmarkwei/x-commerce","commit_stats":null,"previous_names":["juliusmarkwei/x-commerce"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/juliusmarkwei/x-commerce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusmarkwei%2Fx-commerce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusmarkwei%2Fx-commerce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusmarkwei%2Fx-commerce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusmarkwei%2Fx-commerce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juliusmarkwei","download_url":"https://codeload.github.com/juliusmarkwei/x-commerce/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusmarkwei%2Fx-commerce/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31872615,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ecommerce","nextjs","redux","scss","ui"],"created_at":"2025-03-13T20:17:45.799Z","updated_at":"2026-04-16T05:31:26.093Z","avatar_url":"https://github.com/juliusmarkwei.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# X-Commerce Application\r\n\r\nWelcome to the **X-Commerce Application** repository! This project is an ongoing development effort to build a modern and scalable eCommerce web application using the latest technologies. If you find this project interesting or useful, consider giving it a star on GitHub! ⭐\r\n\r\n## Project Overview\r\n\r\nThe **X-Commerce Application** is a full-featured eCommerce platform built with **Next.js**, **Redux**, **Redux-Persist**, **React Hooks**, **SCSS**, and **BEM methodology** for structured styling. The goal of this project is to create a high-performance online shopping experience with a responsive and user-friendly design.\r\n\r\nThis application includes essential eCommerce functionalities such as product listings, a shopping cart, user authentication, and a streamlined checkout process. The design is based on a free **Adobe XD eCommerce UI kit** provided by **ICEO**.\r\n\r\n## Technologies Used\r\n\r\nThe project leverages the following technologies:\r\n\r\n- **Next.js** - A React-based framework for server-side rendering (SSR) and static site generation (SSG).\r\n- **Redux \u0026 Redux-Persist** - For efficient state management and data persistence.\r\n- **React Hooks** - To manage component logic in a functional approach.\r\n- **SCSS \u0026 BEM (Block Element Modifier)** - For modular, maintainable, and reusable styling.\r\n- **Mock Data API** - The backend functionality is currently simulated using static mock data stored in the `utils/data` directory.\r\n\r\n## Getting Started\r\n\r\nTo set up and run the application on your local machine, follow these simple steps:\r\n\r\n### 1. Clone the Repository\r\n\r\nOpen a terminal and execute the following command to clone the repository:\r\n\r\n```bash\r\n  git clone https://github.com/juliusmarkwei/x-commerce.git\r\n  cd x-commerce/\r\n```\r\n\r\n### 2. Install Dependencies\r\n\r\nEnsure you have **Node.js** and **Yarn** installed, then install the required dependencies:\r\n\r\n```bash\r\n  yarn install\r\n```\r\n\r\n### 3. Start the Development Server\r\n\r\nRun the following command to start the local development server:\r\n\r\n```bash\r\n  yarn dev\r\n```\r\n\r\nOnce the server is running, open your browser and navigate to:\r\n\r\n```\r\n  http://localhost:3000\r\n```\r\n\r\nYou should now see the application up and running!\r\n\r\n## Application Features\r\n\r\nThe X-Commerce Application provides the following core functionalities:\r\n\r\n- **Homepage (`/`)** – Displays featured products and promotional content.\r\n- **Product Listing Page (`/products`)** – Shows a grid of available products.\r\n- **Product Detail Page (`/product/:id`)** – Displays in-depth information about a selected product.\r\n- **Shopping Cart (`/cart`)** – Allows users to manage selected products before checkout.\r\n- **User Authentication** – Login (`/login`) and Registration (`/register`) pages for account management.\r\n- **404 Error Page (`/page-not-found`)** – A custom-designed error page for handling incorrect URLs.\r\n- **Checkout Process** – A structured order placement and checkout experience (future development).\r\n\r\n## Backend Information\r\n\r\nAt the moment, the application does not use a fully developed backend. Instead, it relies on mock data stored in the `utils/data` directory. Next.js API routes (`/api`) handle API-like interactions, making it easier to integrate a real backend in the future.\r\n\r\n## Design \u0026 UI/UX\r\n\r\nThe UI design of this project is based on a free **Adobe XD eCommerce UI kit** by **ICEO**. You can check out the original UI kit here:\r\n[ICEO eCommerce UI Kit](https://www.xdguru.com/free-xd-ecommerce-ui-kit-by-iceo/)\r\n\r\n## Screenshots\r\n\r\nBelow are some screenshots showcasing the application's UI:\r\n\r\n![X-Commerce Screenshot](https://lucaspulliese.com/wp-content/uploads/2020/09/ecommerce-1.jpg)\r\n\r\n![X-Commerce Screenshot](https://lucaspulliese.com/wp-content/uploads/2020/09/ecommerce-2.jpg)\r\n\r\n## Project Structure\r\n\r\nThe repository follows a well-organized structure to ensure scalability and maintainability:\r\n\r\n```\r\n├── LICENSE\r\n├── README.md\r\n├── next-env.d.ts\r\n├── next.config.js\r\n├── package.json\r\n├── public/\r\n│   ├── favicon.ico\r\n│   ├── images/\r\n│   │   ├── featured-1.jpg\r\n│   │   ├── featured-2.jpg\r\n│   │   ├── featured-3.jpg\r\n│   │   ├── icons/\r\n│   │   │   └── gmail.svg\r\n│   │   ├── logo.svg\r\n│   │   ├── products/\r\n│   │   │   ├── product-1.jpg\r\n│   │   │   ├── product-2.jpg\r\n│   │   │   ├── product-3.jpg\r\n│   │   └── subscribe.jpg\r\n├── src/\r\n│   ├── assets/\r\n│   │   ├── css/\r\n│   │   │   ├── main.scss\r\n│   │   │   ├── partials/\r\n│   │   │   │   ├── variables.scss\r\n│   │   ├── icons/\r\n│   ├── components/\r\n│   │   ├── footer/\r\n│   │   ├── header/\r\n│   │   ├── product-item/\r\n│   │   ├── product-single/\r\n│   │   ├── shopping-cart/\r\n│   ├── layouts/\r\n│   │   ├── 404.tsx\r\n│   │   ├── Main.tsx\r\n│   ├── pages/\r\n│   │   ├── 404.tsx\r\n│   │   ├── index.tsx\r\n│   │   ├── login.tsx\r\n│   │   ├── register.tsx\r\n│   │   ├── products.tsx\r\n│   │   ├── product/\r\n│   │   │   ├── [pid].tsx\r\n│   │   ├── cart/\r\n│   │   │   ├── checkout.tsx\r\n│   ├── store/\r\n│   │   ├── reducers/\r\n│   │   │   ├── cart.ts\r\n│   │   │   ├── user.ts\r\n│   ├── utils/\r\n│   │   ├── data/\r\n│   │   │   ├── products.ts\r\n│   │   │   ├── products-colors.ts\r\n│   │   │   ├── products-sizes.ts\r\n│   │   ├── services.ts\r\n│   ├── tsconfig.json\r\n│   └── yarn.lock\r\n```\r\n\r\n## Future Enhancements\r\n\r\nThe following features are planned for future updates:\r\n\r\n- **Full Backend Integration** – Connecting to a real database and authentication system.\r\n- **Product Search \u0026 Filtering** – Implementing advanced search and filtering options.\r\n- **User Profiles \u0026 Order History** – Allowing users to manage their orders and preferences.\r\n- **Wishlist Functionality** – Enabling users to save products for later.\r\n- **Payment Gateway Integration** – Adding secure payment processing with Stripe, PayPal, etc.\r\n\r\n## Contributions\r\n\r\nContributions are welcome! If you would like to improve the project, feel free to fork the repository, make changes, and submit a pull request.\r\n\r\n## License\r\n\r\nThis project is open-source and licensed under the **MIT License**.\r\n\r\n---\r\n\r\nThank you for checking out **X-Commerce Application**! If you have any feedback or suggestions, feel free to reach out. Happy coding! 🚀\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliusmarkwei%2Fx-commerce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuliusmarkwei%2Fx-commerce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliusmarkwei%2Fx-commerce/lists"}