Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/fredy-rizo/ecommerce-delivery-frontend/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you from a fresh clone of the repository to a running development server with hot-reload. You will need a backend API instance reachable over HTTP/HTTPS — see the note at the bottom for details. Total setup time is under five minutes on a standard developer machine.
1

Install dependencies

Clone the repository (or open your existing local copy) and install all Node dependencies. Both npm and yarn are supported.
yarn
The install resolves Vue 3, Quasar 2, Vuex 4, Vue Router 4, Axios, Socket.io-client, Firebase, and all Webpack dev-tooling declared in package.json.
2

Configure environment variables

The project loads runtime configuration from a prod.env file in the repository root via @quasar/quasar-app-extension-dotenv. Create the file by copying the provided template:
cp prod.env prod.env.local
# edit prod.env with your actual values
Then populate prod.env with your environment values:
prod.env
PORT=8080
API_SERVER=https://your-backend.example.com
PLATFROM=web
VariableDescription
PORTPort the Quasar dev server listens on. Defaults to 8080 when left blank.
API_SERVERBase URL of your backend REST API. Injected as baseURL for the Axios $api instance.
PLATFROMDeployment platform identifier (note: the key is intentionally spelled PLATFROM in the env file — do not correct the spelling or the variable will not be read).
Firebase keys (API_KEY, AUTH_DOMAIN, PROJECT_ID, STORAGE_BUCKET, MESSAGING_SENDER_ID, APP_ID, MEASUREMENT_ID) are also read from prod.env. See the Configuration page for the full variable reference.
3

Start the development server

Run the Quasar dev command from the project root:
quasar dev
Quasar compiles the application with Webpack, starts a dev server on port 8080 (or the value of PORT), and automatically opens your default browser. Hot-module replacement is active — changes to .vue and .js files are reflected instantly without a full page reload.You should see output similar to:
 App • READY  
 Dev server at: http://localhost:8080/
4

Build for production

When you are ready to ship, produce an optimised static bundle:
quasar build
The web build outputs to dist/spa/. The Capacitor Android build produces a native APK/AAB you can sign and distribute through the Google Play Store. To regenerate app icons after changing icon.png, run:
icongenie generate -m capacitor -i ./icon.png
The application requires a running backend API server. Set API_SERVER in prod.env to the full base URL of that server (e.g. https://api.example.com) before starting the dev server. All HTTP calls made through this.$api use this value as their baseURL. Without a valid backend the login screen will appear but all authenticated requests will fail.
The repository ships a .vscode/extensions.json file with recommended VS Code extensions including ESLint, Prettier, EditorConfig, Volar (Vue 3), and TODO Highlight. When you open the project in VS Code you will be prompted to install them automatically — accepting that prompt gives you syntax highlighting, in-editor linting, and format-on-save out of the box.

Build docs developers (and LLMs) love

Get started for freeTalk to us