{"id":13406478,"url":"https://github.com/ever-co/ever-demand","last_synced_at":"2025-05-15T07:04:39.841Z","repository":{"id":37175707,"uuid":"146113277","full_name":"ever-co/ever-demand","owner":"ever-co","description":"Ever® Demand™ - Open Commerce Platform - https://everdemand.co","archived":false,"fork":false,"pushed_at":"2024-05-01T21:18:53.000Z","size":38840,"stargazers_count":1789,"open_issues_count":71,"forks_count":474,"subscribers_count":79,"default_branch":"develop","last_synced_at":"2025-05-07T17:05:28.876Z","etag":null,"topics":["angular","commerce","commerce-platform","e-commerce","ecommerce","ecommerce-platform","framework","graphql","headless","ionic","javascript","marketplace","multivendor","nodejs","on-demand","platform","shop","shopping-website","storefront","typescript"],"latest_commit_sha":null,"homepage":"https://everdemand.co","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ever-co.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-25T16:53:47.000Z","updated_at":"2025-05-02T15:03:16.000Z","dependencies_parsed_at":"2023-02-18T06:16:09.314Z","dependency_job_id":"c19b6daf-a150-457d-a6fc-2a7a42901a8d","html_url":"https://github.com/ever-co/ever-demand","commit_stats":null,"previous_names":["ever-co/ever"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ever-co%2Fever-demand","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ever-co%2Fever-demand/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ever-co%2Fever-demand/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ever-co%2Fever-demand/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ever-co","download_url":"https://codeload.github.com/ever-co/ever-demand/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253639579,"owners_count":21940446,"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":["angular","commerce","commerce-platform","e-commerce","ecommerce","ecommerce-platform","framework","graphql","headless","ionic","javascript","marketplace","multivendor","nodejs","on-demand","platform","shop","shopping-website","storefront","typescript"],"created_at":"2024-07-30T19:02:31.350Z","updated_at":"2025-05-15T07:04:34.825Z","avatar_url":"https://github.com/ever-co.png","language":"TypeScript","funding_links":[],"categories":["graphql","TypeScript","angular","⚙️ Backend \u0026 APIs"],"sub_categories":[],"readme":"# Open Commerce Platform\n\n[![Gitpod Ready-to-Code](https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/ever-co/ever-demand)\n[![Join the community on Spectrum](https://withspectrum.github.io/badge/badge.svg)](https://spectrum.chat/ever)\n[![Gitter](https://badges.gitter.im/JoinChat.svg)](https://gitter.im/ever-co/ever?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![Get help on Codementor](https://cdn.codementor.io/badges/get_help_github.svg)](https://www.codementor.io/evereq?utm_source=github\u0026utm_medium=button\u0026utm_term=evereq\u0026utm_campaign=github)\n\n## 💡 What's New\n\nWe released [Ever Teams](https://github.com/ever-co/ever-teams) - an Open Work and Project Management Platform.  \nPlease check \u003chttps://github.com/ever-co/ever-teams\u003e and make it ⭐ on GitHub!  \nIt's built with a React and React Native stack and connects to headless [Ever Gauzy Platform](https://github.com/ever-co/ever-gauzy) APIs.\n\n## 🌟 What is it\n\n[Ever® Demand™](https://ever.co) - Open Platform for **Collaborative**, **On-Demand** and **Sharing** **Economies**.  \n\nIt's an Open-Source, Real-Time, and Reactive Platform built with [TypeScript](http://www.typescriptlang.org).  \nYou are welcome to check more information about the platform at our official website - **\u003chttps://ever.co\u003e**.\n\n![overview](https://docs.ever.co/overview_small.png)\n\n## 💻 Demos\n\n**Demos are not available at the moment as we are moving to Kubernetes and showdown old demo server!**\n\n\u003c!---\n\n-   [Admin Website](http://demo.ever.co:4200), use admin user email: `admin@ever.co`, password: `admin`\n-   [Shopping Mobile App](http://demo.ever.co:4201)\n-   [Merchant Ionic Tablet App](http://demo.ever.co:4202)\n-   [Carrier Mobile App](http://demo.ever.co:4203)\n-   [Shopping Website](http://demo.ever.co:3000)\n\n--\u003e\n\n## Video Intros\n\n- Introduction of both Ever Demand and Ever Gauzy platforms - [view video](https://www.loom.com/share/ff9a9b1fa3a849cca5cf68a6d502443b) (~30 min) or [download](https://media.githubusercontent.com/media/ever-co/ever-demand-docs/master/docs/assets/videos/EverDemandAndGauzyIntro.mp4)\n- Introduction to Ever Demand Mobile Shop customer experience (UX) - [view video](https://www.loom.com/share/488f774e6b6d4ee88107443ce4522f1f) (~30 min) or [download](https://media.githubusercontent.com/media/ever-co/ever-demand-docs/master/docs/assets/videos/EverDemandMobileShopIntro.mp4)\n\n## ✨ Features\n\n### Current Features\n\n-   Supports Single-Store and Multi-Store / Multi-Vendor / Peer-to-Peer / Digital Marketplaces\n-   Everything Reactive, Real-Time, and Blazing Fast!\n-   Headless Commerce framework, which allows different implementations of store-fronts, Admin UIs, and client apps. It exposes rich GraphQL, REST, and WS APIs.\n-   Mobile ordering App for customers to make On-Demand orders (Hybrid / PWA, iOS and Android using Ionic / Ionic Native)\n-   Carrier (Driver) Mobile App for deliveries by carriers, drivers, or service providers (iOS and Android using Ionic / Ionic Native)\n-   Customizing Shopping e-commerce Website for customers to make in-browser On-Demand purchases of food, goods or services\n-   Merchant Tablet App for Stores/Merchants/Warehouses to manage \u0026 track orders, organize deliveries, etc.\n-   Admin Website used to manage all platform features and settings in the single Web-based interface\n-   Multi-language and culture settings across Platform (i18N)\n-   Product catalogs (global and per Merchant) with Multiple Product Images\n-   Inventory/Stock Management and Real-time Order Management/Processing across the Platform\n-   Deliveries/Shipping management and processing across the Platform (shipping with real-time location tracking for On-Demand orders)\n-   Real-time discounts, promotions, and product/service availability updates\n-   Customer registration, Guest Checkouts, Invitations (optional)\n-   Gateway and Payment Processing (currently supported Payments Gateway - [Stripe](https://stripe.com))\n-   Plugins / Extensions / Custom Fields (WIP)\n\n### Planned Features\n\n-   Tax Calculations\n-   Third-party Shipping provider integrations\n-   User Roles / Permissions across Platform\n-   Large product catalogs with product variants, facets, and full-text search\n\nYou can also track feature requests from the community in the [separate repo](https://github.com/ever-co/feature-requests/issues).\n\n### Disclaimer\n\n_A word of caution_: We are in α (alpha), i.e. Ever® Platform™ is very much under development (work in progress, WIP).\nExpect _lots_ of changes and some :bug: and please be nice! :stuck_out_tongue_winking_eye:\n\n## 🧱 Technology Stack and Requirements\n\n-   Full-stack [TypeScript](https://www.typescriptlang.org) - frontends and [NodeJs](https://nodejs.org)/[Nest](https://github.com/nestjs/nest) backend.\n-   Headless Commerce framework (Backend APIs/Server) developed using [Nest](https://github.com/nestjs/nest). Supports GraphQL, REST and WS Real-Time APIs (WebSockets using [Socket.io](https://socket.io) library).\n-   [Ionic](https://ionicframework.com) (version 5) for Carrier Mobile App and Merchant Tablet App.\n-   Shopping Mobile App built with [Ionic](https://ionicframework.com) (version 5).\n-   Shopping Mobile App built with [React Native](https://github.com/facebook/react-native) using [Expo](https://github.com/expo/expo) (WIP).\n-   Shopping Mobile App built with [Flutter](https://github.com/flutter/flutter) / Dart (WIP).\n-   Shopping Website developed with [Angular](https://angular.io) (version 9.1) using [Angular Starter](https://github.com/gdi2290/angular-starter).\n-   Admin Website developed with [Angular](https://angular.io) (version 9.1) using [ngx-admin](https://github.com/akveo/ngx-admin).\n-   [RxJS](http://reactivex.io/rxjs) library used heavily in every part of the Platform.\n-   [InversifyJS](http://inversify.io) used for Inversion Control / Dependency Injection in most parts of the Platform. On the Backend/API we also use DI provided by [Nest](https://github.com/nestjs/nest).\n-   [MongoDB](https://www.mongodb.com) Database used with [Mongoose](https://mongoosejs.com) ORM (supported MongoDB version \u003e= 3.2; we recommend version \u003e=4).\n-   We have an ongoing effort (WIP) to add support for other databases using [TypeORM](https://github.com/typeorm/typeorm) and [Prisma](https://github.com/prisma/prisma). The following additional DBs will be fully supported: MySQL, PostgreSQL, MariaDB, SQLite, MS SQL Server, and Oracle.\n-   For production, we integrate and recommend using [PM2](https://github.com/Unitech/pm2).\n\n#### See also README.md and CREDITS.md files in relevant folders for lists of libraries and software included in the Platform, information about licenses and other details.\n\n## 📄 Documentation\n\nPlease refer to our official [Platform Documentation](https://docs.ever.co) and to our [Wiki](https://github.com/ever-co/ever-demand/wiki) (WIP).\n\nFor a quick overview of each project in the Platform (Server, Admin, Shops, etc.), you can search for the README.md file in the root of the project's folders. For example, see [./backend/api/README.md](backend/api/README.md) for Server (Backend) related overview.\n\n## 📊 Activity\n\n![Alt](https://repobeats.axiom.co/api/embed/4e666433c785034fea1712b91f5f7d09ed009385.svg \"Repobeats analytics image\")\n\n## 🚀 Getting Started\n\nWe follow [Gitflow Workflow](https://nvie.com/posts/a-successful-git-branching-model), so the [`develop` branch](https://github.com/ever-co/ever-demand/tree/develop) may be in an unstable or even broken state during development. Please use [releases](https://github.com/ever-co/ever/releases) or [`master` branch](https://github.com/ever-co/ever-demand/tree/master) instead of the `develop` branch in order to get more stable code.\n\n### Clone Repo\n\nClone the Ever Platform Git repo:\n\n```\ngit clone https://github.com/ever-co/ever-demand.git\n```\n\n**IMPORTANT NOTE:**\n\n-   If you want to use a develop branch (unstable, but latest development) clone using `--branch develop` (our default branch).\n-   If you want to use a release branch (more stable) clone use `--branch master`.\n\n### Yarn\n\nCurrently, we are using `Yarn` (instead of `npm`), so make sure you have the latest Yarn version installed before running Ever Platform:\n\n```\nnpm install -g yarn@latest\n```\n\n### Quick installation\n\nAfter this GitHub repo is cloned, just run the following command to install/bootstrap all dependencies:\n\n```\nyarn bootstrap\n```\n\nThe above command installs the required packages in all Platform projects using Lerna.\n\nNote: if the above command fails for any reason, you can try to install the required packages manually by running `yarn` inside every sub-folder of the `packages` folder with the 'package.json' file\n\n### Build\n\nYou can build all projects in Ever Platform using the single command below:\n\n```\nyarn build:all\n```\n\nNote: The parallel build is available using `yarn build` command\n\n### Lerna (manual installation)\n\nWe are using [Lerna](https://github.com/lerna/lerna) for mono-repo management.\nYou need to run the following command from the working folder where you cloned the Ever Demand Git repo, which installs Lerna together with other packages:\n\n```\nyarn\n```\n\nYou may instead install Lerna globally:\n\n```\nnpm install lerna@latest -g\n```\n\nNow, after Lerna is installed (locally or globally), you need to Bootstrap all dependencies manually:\n\n```\nyarn lerna bootstrap\n```\n\nThe command above installs all required packages for every sub-project of the Ever Platform.\n\nNote: if the above command fails for any reason, you can try to install the required packages manually by running `yarn` inside every sub-folder with 'package.json' file.\n\nAfter Lerna bootstraps everything you need to run the build for all projects as described above in the \"Build\" section.\n\n### MongoDB\n\nEver Demand platform configured to use MongoDB by default and assume you have MongoDB service running and accepting connections on the default `localhost:27017`. Please see relevant section in our [documentation](https://github.com/ever-co/ever-demand/wiki/MongoDB).\n\n### Platform Configuration\n\nSee the relevant section in our [documentation](https://github.com/ever-co/ever-demand/wiki/Ever-Platform-Configuration).\n\n### Run Platform Projects\n\nAfter you build everything (`yarn build:all`, described above), each project from Ever Platform could be started by single command from this list:\n\n-   Run API server `yarn run:server`\n-   Run Admin Website `yarn run:admin` and open http://localhost:4200\n-   Run Shopping Mobile App `yarn run:shopmobile` and open http://localhost:4201\n-   Run Merchant Ionic Tablet App `yarn run:merchant` and open http://localhost:4202\n-   Run Carrier Mobile app `yarn run:carrier` and open http://localhost:4203\n-   Run Shopping Website `yarn run:shopweb` and open http://localhost:3000\n\nNote 1: It is important to build shared / common platform modules (`yarn build:common` or `yarn build:all`) before running the Platform Core (API) or Apps\n\nNote 2: During development, you can run a server with `yarn run:server:dev` to enable watch on TS file changes\n\nNote 3: On the first run, the API Server (Backend) creates MongoDB local database `ever_development` with the following (default) Admin user\n\n-   email: `admin@ever.co`\n-   password: `admin`\n\nYou can use the credentials above to login into Platform Admin App.\n\nNote 3: In order to be able to run every project, you need to make sure everything builds, see section \"Build\" above.\n\n## Metrics\n\nAccording to [cloc](https://github.com/AlDanial/cloc) project, Ever Platform today has more than 120K lines of TypeScript, GraphQL, HTML / CSS and other code files. You can get more details in the relevant section of our [documentation](https://github.com/ever-co/ever-demand/wiki/Metrics).\n\n## 💌 Contact Us\n\n-   [Ever.co Website Contact Us page](https://ever.co/contacts)\n-   [Discord Chat](https://discord.gg/msqRJ4w)\n-   [Slack Community](https://join.slack.com/t/everplatform/shared_invite/enQtNzc2NzI1OTgwMjQwLTBkODI3OTU2ZDI1YTQwNWE3OGExYWUwYjE5NThkMjRiYjA0NmFiNzZhYWUzNWViNWI4Nzg2YTc3MzY2MjY0YzU)\n-   [Spectrum Community](https://spectrum.chat/ever)\n-   [Gitter Chat](https://gitter.im/ever-co/ever)\n-   [CodeMentor](https://www.codementor.io/evereq)\n-   [Telegram](https://t.me/everplatform)\n-   For business inquiries: \u003cmailto:ever@ever.co\u003e\n-   Please report security vulnerabilities to \u003cmailto:security@ever.co\u003e\n-   [Ever Platform @ Twitter](https://twitter.com/everplatform)\n-   [Ever Platform @ Facebook](https://www.facebook.com/everplatform)\n\n## 🔐 Security\n\nEver® Demand™ Platform follows good security practices, but 100% security cannot be guaranteed in any software!\nEver® Demand™ Platform is provided AS IS without any warranty. Use at your own risk!\nSee more details in the [LICENSE.md](LICENSE.md).\n\nIn a production setup, all client-side to server-side (backend, APIs) communications should be encrypted using HTTPS/WSS/SSL (REST APIs, GraphQL endpoint, Socket.io WebSockets, etc.).\n\nIf you discover any issue regarding security, please disclose the information responsibly by sending an email to \u003cmailto:security@ever.co\u003e or on [![huntr](https://cdn.huntr.dev/huntr_security_badge_mono.svg)](https://huntr.dev) and not by creating a GitHub issue.\n\n## 🛡️ License\n\nWe support the open-source community. If you're building awesome non-profit/open-source projects, we're happy to help and will provide (subject to [acceptance criteria](https://github.com/ever-co/ever-demand/wiki/Free-license-and-hosting-for-Non-profit-and-Open-Source-projects)) Ever Demand Enterprise edition license and free hosting option! Feel free to contact us at \u003cmailto:ever@ever.co\u003e to make a request. More details are explained in our [Wiki](https://github.com/ever-co/ever-demand/wiki/Free-license-and-hosting-for-Non-profit-and-Open-Source-projects).\n\nThis software is available under the following licenses:\n\n-   [Ever® Demand™ Platform Community Edition](https://github.com/ever-co/ever-demand/blob/master/LICENSE.md#ever-platform-community-edition-license)\n-   [Ever® Demand™ Platform Small Business](https://github.com/ever-co/ever-demand/blob/master/LICENSE.md#ever-platform-small-business-license)\n-   [Ever® Demand™ Platform Enterprise](https://github.com/ever-co/ever-demand/blob/master/LICENSE.md#ever-platform-enterprise-license)\n\n#### The default Ever® Demand™ Platform license, without a valid Ever® Demand™ Platform Enterprise or Ever® Demand™ Platform Small Business License agreement, is the Ever® Demand™ Platform Community Edition License.\n\n#### Please see [LICENSE.md](LICENSE.md) for more information on licenses. You can also [compare our offering](https://ever.co/compare-ever/#compare).\n\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fever-co%2Fever.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fever-co%2Fever?ref=badge_large)\n\n## Trademarks\n\n**Ever**® is a registered trademark of [Ever Co. LTD](https://ever.co).\n**Ever® Demand™**, **Ever® Gauzy™** and **Ever® OpenSaaS™** are all trademarks of [Ever Co. LTD](https://ever.co).\n\nThe trademarks may only be used with the written permission of Ever Co. LTD. and may not be used to promote or otherwise market competitive products or services.\n\nAll other brand and product names are trademarks, registered trademarks, or service marks of their respective holders.\n\n## 🍺 Contribute\n\n-   Please give us :star: on Github, it **helps**!\n-   You are more than welcome to submit feature requests in the [separate repo](https://github.com/ever-co/feature-requests/issues)\n-   Pull requests are always welcome! Please base pull requests against the _develop_ branch and follow the [contributing guide](.github/CONTRIBUTING.md).\n\n## 💪 Thanks to our Contributors\n\nSee our contributors list in [CONTRIBUTORS.md](https://github.com/ever-co/ever-demand/blob/develop/.github/CONTRIBUTORS.md).  \nYou can also view a full list of our [contributors tracked by Github](https://github.com/ever-co/ever-demand/graphs/contributors).\n\n\u003cimg src=\"https://contributors-img.web.app/image?repo=ever-co/ever-demand\" /\u003e\n\n## ⭐ Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=ever-co/ever-demand\u0026type=Date)](https://star-history.com/#ever-co/ever-demand\u0026Date)\n\n## ❤️ Powered By\n\n\u003cp\u003e\n  \u003ca href=\"https://www.digitalocean.com/?utm_medium=opensource\u0026utm_source=ever-co\"\u003e\n    \u003cimg src=\"https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/PoweredByDO/DO_Powered_by_Badge_blue.svg\" width=\"201px\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## ©️ Copyright\n\n#### Copyright © 2016-present, Ever Co. LTD. All rights reserved.\n\n---\n\n![visitors](https://visitor-badge.laobi.icu/badge?page_id=ever-co.ever-platform)\n[![huntr](https://cdn.huntr.dev/huntr_security_badge_mono.svg)](https://huntr.dev)\n[![Circle CI](https://circleci.com/gh/ever-co/ever-demand.svg?style=svg)](https://circleci.com/gh/ever-co/ever-demand)\n[![codecov](https://codecov.io/gh/ever-co/ever-demand/branch/master/graph/badge.svg)](https://codecov.io/gh/ever-co/ever-demand)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/ec4b3c9e71ff42919563f1809de4e601)](https://www.codacy.com/gh/ever-co/ever-demand/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=ever-co/ever-demand\u0026amp;utm_campaign=Badge_Grade)\n[![DeepScan grade](https://deepscan.io/api/teams/3293/projects/4849/branches/38566/badge/grade.svg)](https://deepscan.io/dashboard#view=project\u0026tid=3293\u0026pid=4849\u0026bid=38566)\n[![Known Vulnerabilities](https://snyk.io/test/github/ever-co/ever-demand/badge.svg)](https://snyk.io/test/github/ever-co/ever-demand)\n[![Total alerts](https://img.shields.io/lgtm/alerts/g/ever-co/ever-demand.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/ever-co/ever-demand/alerts/)\n[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/ever-co/ever-demand.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/ever-co/ever-demand/context:javascript)\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fever-co%2Fever-demand.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fever-co%2Fever-demand?ref=badge_shield)\n[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lernajs.io)\n[![Crowdin](https://badges.crowdin.net/e/581540ddcc7c1cf42a50d0e0a6a3d7f7/localized.svg)](https://ever.crowdin.com/ever)\n\n## 🔥 P.S.\n\n-   If you are running any business or doing freelance, check our new project [Ever Gauzy](https://github.com/ever-co/ever-gauzy) - Open Business Management Platform (ERP/CRM/HRM)\n-   [We are Hiring: remote TypeScript / NodeJS / NestJS / Angular \u0026 React developers](https://github.com/ever-co/jobs#available-positions)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fever-co%2Fever-demand","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fever-co%2Fever-demand","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fever-co%2Fever-demand/lists"}