{"id":13602084,"url":"https://github.com/shopizer-ecommerce/shopizer","last_synced_at":"2025-05-13T17:07:41.617Z","repository":{"id":5583386,"uuid":"6789509","full_name":"shopizer-ecommerce/shopizer","owner":"shopizer-ecommerce","description":"Shopizer java e-commerce software","archived":false,"fork":false,"pushed_at":"2025-03-23T16:16:56.000Z","size":566507,"stargazers_count":3699,"open_issues_count":556,"forks_count":3097,"subscribers_count":297,"default_branch":"3.2.7","last_synced_at":"2025-04-24T01:57:58.861Z","etag":null,"topics":["apache2","cloud","e-commerce","java","retail","shopizer","springboot","springframework","springmvc"],"latest_commit_sha":null,"homepage":"http://www.shopizer.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shopizer-ecommerce.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null}},"created_at":"2012-11-21T03:42:39.000Z","updated_at":"2025-04-23T23:08:01.000Z","dependencies_parsed_at":"2023-10-02T21:32:26.176Z","dependency_job_id":"c3d36849-7661-4986-8ce9-d57b577a45ff","html_url":"https://github.com/shopizer-ecommerce/shopizer","commit_stats":{"total_commits":23,"total_committers":5,"mean_commits":4.6,"dds":"0.17391304347826086","last_synced_commit":"42e5937f6b39d0227de5b4e65b610cdc53b2ade2"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopizer-ecommerce%2Fshopizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopizer-ecommerce%2Fshopizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopizer-ecommerce%2Fshopizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopizer-ecommerce%2Fshopizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shopizer-ecommerce","download_url":"https://codeload.github.com/shopizer-ecommerce/shopizer/tar.gz/refs/heads/3.2.7","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253990466,"owners_count":21995774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["apache2","cloud","e-commerce","java","retail","shopizer","springboot","springframework","springmvc"],"created_at":"2024-08-01T18:01:13.801Z","updated_at":"2025-05-13T17:07:36.603Z","avatar_url":"https://github.com/shopizer-ecommerce.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"# Shopizer 3.X (for java 1.11 +) (tested with Java 11, 16 and 17)\n# Created By Shamshad\n\u003e [!NOTE]\n\u003e The team is working on an upcoming efficient microservices version. Stay tuned !\n\n[![last_version](https://img.shields.io/badge/last_version-v3.2.5-blue.svg?style=flat)](https://github.com/shopizer-ecommerce/shopizer/tree/3.2.5)\n[![Official site](https://img.shields.io/website-up-down-green-red/https/shields.io.svg?label=official%20site)](http://www.shopizer.com/)\n[![Docker Pulls](https://img.shields.io/docker/pulls/shopizerecomm/shopizer.svg)](https://hub.docker.com/r/shopizerecomm/shopizer)\n[![stackoverflow](https://img.shields.io/badge/shopizer-stackoverflow-orange.svg?style=flat)](http://stackoverflow.com/questions/tagged/shopizer)\n[![CircleCI](https://circleci.com/gh/shopizer-ecommerce/shopizer.svg?style=svg)](https://circleci.com/gh/shopizer-ecommerce/shopizer)\n\n\nJava open source e-commerce software\n\nHeadless commerce and Rest api for ecommerce\n\n- Catalog\n- Shopping cart\n- Checkout\n- Merchant\n- Order\n- Customer\n- User\n\n\nShopizer Headless commerce consists of the following components:\n\n- Spring boot Java / Spring boot backend\n- Angular administration web application\n- React JS front end application\n\nPrerequisites\n\nBefore you begin, ensure you have the following installed on your system:\n\nJava 11+ (tested with Java 11, 16, and 17)\n\nMaven (for building the project)\n\nDocker (optional, for containerized deployment)\n\nSee the demo: [**New demo on the way 2023]\n-------------------\nHeadless demo Available soon\n\n1.  Run from Docker images:\n\nFrom the command line:\n\n```\ndocker run -p 8080:8080 shopizerecomm/shopizer:latest\n```\n       \n2. Run the administration tool\n\n⋅⋅⋅ Requires the java backend to be running\n\n```\ndocker run \\\n -e \"APP_BASE_URL=http://localhost:8080/api\" \\\n -p 82:80 shopizerecomm/shopizer-admin\n```\n\n\n3. Run React Shop Sample Site\n\n⋅⋅⋅ Requires the Java backend to be running.\n\n- **Reason**: The React Shop sample site interacts with the backend API to retrieve and display products, handle customer authentication, and process orders. Without the backend running, the frontend will not be able to fetch necessary data or execute actions.\n\n- **Steps**:\n   1. Ensure the backend is running using the steps outlined in the previous section.\n   2. Run the following Docker command to start the React Shop sample site:\n      ```bash\n      docker run \\\n      -e \"APP_MERCHANT=DEFAULT\" \\\n      -e \"APP_BASE_URL=http://localhost:8080\" \\\n      -p 80:80 shopizerecomm/shopizer-shop-reactjs\n      ```\n\n- **Access**: Once the site is running, you can access it at [http://localhost:80](http://localhost:80).\n\n- **Troubleshooting**: If the site does not load properly, check:\n  1. That the backend service is running without errors.\n  2. That there are no network conflicts on port `80` or `8080`.\n\n\nAPI documentation:\n-------------------\n\nhttps://app.swaggerhub.com/apis-docs/shopizer/shopizer-rest-api/3.0.1#/\n\nGet the source code:\n-------------------\nClone the repository:\n     \n\t $ git clone git://github.com/shopizer-ecommerce/shopizer.git\n\t \n\t $ git clone git://github.com/shopizer-ecommerce/shopizer-admin.git\n\t \n\t $ git clone git://github.com/shopizer-ecommerce/shopizer-shop-reactjs.git\n\nIf this is your first time using Github, review http://help.github.com to learn the basics.\n\nYou can also download the zip file containing the code from https://github.com/shopizer-ecommerce for each of the the projects above\n\nTo build the application:\n-------------------\n\n1. Shopizer backend\n\n\nFrom the command line:\n\n\t$ cd shopizer\n\t$ mvnw clean install\n\t$ cd sm-shop\n\t$ mvnw spring-boot:run\n\n2. Shopizer admin\n\nForm compiling and running Shopizer admin consult the repo README file\n\n3. Shop sample site\n\nForm compiling and running Shopizer admin consult the repo README file\n\n\n### Access the application:\n-------------------\n\nAccess the headless web application at: http://localhost:8080/swagger-ui.html\n\n\nThe instructions above will let you run the application with default settings and configurations.\nPlease read the instructions on how to connect to MySQL, configure an email server and configure other subsystems\n\n\n### Documentation:\n-------------------\n\n### Documentation and Resources\n\n1. **Official Documentation**:\n   - **Description**: Comprehensive guide covering setup, configuration, and advanced usage of Shopizer.\n   - **Link**: [Shopizer Documentation](https://shopizer-ecommerce.github.io/documentation/)\n\n2. **API Documentation**:\n   - **Description**: Explore all available API endpoints with examples and detailed descriptions. Ideal for developers integrating Shopizer into their applications.\n   - **Link**: [Shopizer API Documentation](https://app.swaggerhub.com/apis-docs/shopizer/shopizer-rest-api/3.0.1#/)\n\n3. **Community and Support**:\n   - **Slack Channel**:\n     - **Description**: Join the Shopizer community on Slack to ask questions, share feedback, and get support from other users and developers.\n     - **Link**: [Join Slack Channel](https://communityinviter.com/apps/shopizer/shopizer)\n   - **ChatOps**:\n     - **Description**: Direct link to the Shopizer workspace on Slack for real-time discussions.\n     - **Link**: [Shopizer Slack Workspace](https://shopizer.slack.com)\n\n4. **Official Website**:\n   - **Description**: Learn more about Shopizer, including news, updates, and additional resources.\n   - **Link**: [Shopizer Website](http://www.shopizer.com)\n\n\n### Participation:\n-------------------\n\nIf you have interest in giving feedback or for participating to Shopizer project in any way\nFeel to use the contact form \u003chttp://www.shopizer.com/contact.html\u003e and share your email address\nso we can send an invite to our Slack channel\n\n### How to Contribute:\n-------------------\nContributing to Shopizer is simple and rewarding. Follow the steps below to get started:\n\n1. **Fork the Repository**:\n   - **Description**: Create your own copy of the repository on your GitHub account by clicking the **Fork** button at the top-right of the repository page.\n   - **Why**: This ensures your changes don’t directly affect the original repository.\n\n2. **Clone from Forked Repository**:\n   - **Description**: Download the forked repository to your local machine to start making changes.\n   - **Command**:\n     ```bash\n     git clone https://github.com/yourusername/shopizer.git\n     cd shopizer\n     ```\n\n3. **Build the Application**:\n   - **Description**: Ensure that the application builds successfully and is ready for development or testing.\n   - **Steps**:\n     - Follow the [Build Steps](#installation-guide) provided earlier in this README.\n\n4. **Synchronize with the Upstream Repository**:\n   - **Description**: Keep your fork updated with the latest changes from the main repository.\n   - **Commands**:\n     ```bash\n     git remote add upstream https://github.com/shopizer-ecommerce/shopizer.git\n     git pull upstream 3.2.5\n     ```\n   - **Why**: Synchronizing ensures your changes are compatible with the latest version of the project.\n\n5. **Create a New Branch**:\n   - **Description**: Always create a new branch for your feature or fix to keep your work organized.\n   - **Command**:\n     ```bash\n     git checkout -b branch-name\n     ```\n   - **Tip**: Use descriptive branch names like `feature-add-product-filter` or `fix-cart-bug`.\n\n6. **Make Your Changes**:\n   - **Description**: Implement the feature, fix the bug, or update the documentation.\n\n7. **Test Your Changes**:\n   - **Description**: Run the application locally and ensure your changes work as intended without breaking existing functionality.\n   - **Tip**: Use tools like Swagger UI to test API changes.\n\n8. **Push Changes to Your Fork**:\n   - **Description**: Push your changes to your forked repository on GitHub.\n   - **Command**:\n     ```bash\n     git push origin branch-name\n     ```\n\n9. **Submit a Pull Request (PR)**:\n   - **Description**: Request to merge your changes into the main repository.\n   - **Steps**:\n     - Navigate to your forked repository on GitHub.\n     - Click the **Compare \u0026 Pull Request** button.\n     - Add a clear title and description explaining your changes.\n   - **Tip**: Mention any related issues (e.g., \\\"Fixes #123\\\") in the description.\n\n10. **Respond to Feedback**:\n    - **Description**: Be prepared to make updates or revisions based on feedback from maintainers.\n    - **Why**: Collaboration ensures your contribution meets project standards.\n\n---\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshopizer-ecommerce%2Fshopizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshopizer-ecommerce%2Fshopizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshopizer-ecommerce%2Fshopizer/lists"}