Effortlessly combine online shopping with convenient in-store pickup for a superior retail experience
BOPIS App: A Seamless Buy Online, Pick Up In-Store Solution Our BOPIS (Buy Online, Pick Up In-Store) app enhances the retail shopping experience by combining the convenience of online shopping with the immediacy of in-store pickup. Perfect for modern shoppers and retailers alike, this app offers a flexible and efficient solution for purchasing and collecting goods.
- Product Browsing: Easily explore a wide range of products available at nearby store locations.
- Real-Time Inventory: Stay updated with live stock levels to ensure items are available for immediate pickup.
- Seamless Order Placement: Enjoy a smooth online ordering process with secure payment options.
- Convenient Store Selection: Choose the most convenient pickup location based on proximity and product availability.
- Flexible Pickup Scheduling: Select your preferred pickup time to match your schedule.
- Timely Notifications: Receive alerts and updates on your order status and readiness for pickup.
- Robust Customer Support: Access assistance and answers to common questions through chat or call features.
By bridging the gap between digital and physical retail, our BOPIS app provides a comprehensive and user-friendly shopping alternative that boosts customer satisfaction and streamlines operations for retailers.
Ionic CLI - If you don't have the ionic CLI installed refer official documentation for the installation instructions.
- Download the app from release page and extract it.
- Go to the app directory.
- Run following command to download dependencies
npm i
- Create a
.env
file by taking reference from the.env.example
and set theVUE_APP_BASE_URL
to the instance you want to connect the app. - To run the app in browser use the command:
ionic serve
- Open a Terminal window
- Clone app using the command:
git clone https://github.com/hotwax/bopis.git <repository-name>
- Go to the directory using command:
cd <repository-name>
- Run following command to download dependencies
npm i
- Create a
.env
file by taking reference from the.env.example
and change theVUE_APP_BASE_URL
to the instance you want to connect the app. - To run the app in browser use the command:
ionic serve
We are using firebase hosting for the Bopis app deployment Here are the steps to deploy app on firebase hosting
- Firebase Cli should be installed
- Firebase project should be created
- You should have access to firebase project
-
Update the DEV instance url at .env.production file
-
Build the application using following command
ionic build
-
Login into firebase
firebase login
-
Run following command to deploy to firebase hosting
firebase deploy --only hosting:sm-dev
As there is a bug in Ionic cli due to which we cannot pass flag variables for commands (See #4669). To build application in different modes we need to use vue-cli-service to build and then use the built app using capacitor copy command further.
Follow following instructions:
-
Manually build the application using vue-cli-service: npx vue-cli-service build --mode=sandbox
-
Copy web assets to the native project without building the app: ionic capacitor copy ios --no-build
-
Open the Android Studio / XCode project: ionic capacitor open android
ionic capacitor open ios
- Fork the repository and clone it locally from the
main
branch. Before starting your work make sure it's up to date with currentmain
branch. - Pick an issue from here. Write in the issue comment that you want to pick it, if you can't assign yourself. Please stay assigned to one issue at a time to not block others.
- Create a branch for your edits. Use the following branch naming conventions: bopis/issue-number.
- Please add issue number to your commit message.
- Propose a Pull Request to
main
branch containing issue number and issue title. - Use Pull Request template (it's automatically added to each PR) and fill as much fields as possible to describe your solution.
- Reference any relevant issues or other information in your PR.
- Wait for review and adjust your PR according to it.
- Congrats! Your PR should now be merged in!
If you can't handle some parts of the issue then please ask for help in the comment. If you have any problems during the implementation of some complex issue, feel free to implement just a part of it.
Always define the type of issue:
- Bug report
- Feature request
While writing issues, please be as specific as possible. All requests regarding support with implementation or application setup should be sent to.
You may find some useful resources for improving the UI / UX of the app here.
If you have any questions or ideas feel free to join our Discord channel.
Bopis app is completely free and released under the Apache v2.0 License. Check LICENSE for more details.