Open Commerce Platform

💡 What's New

• 🔥🔥🔥 we just released Ever Works - An open agentic runtime that autonomously researches, ships, and maintains entire businesses, 24/7. Please grab it now from and make it ⭐⭐⭐ on GitHub!
• if you like Ever Demand, you should also check Ever Gauzy - Open Business Management Platform (ERP/CRM/HRM/ATS/PM). Please check and make it ⭐ on GitHub!

🌟 What is it

Ever® Demand™ - Open Platform for Collaborative, On-Demand and Sharing Economies.

It's an Open-Source, Real-Time, and Reactive Platform built with TypeScript.
You are welcome to check more information about the platform at our official website - ****.

💻 Demos

Demos are not available at the moment as we are moving to Kubernetes and showdown old demo server!

Video Intros

• Introduction of both Ever Demand and Ever Gauzy platforms - view video (~30 min) or download
• Introduction to Ever Demand Mobile Shop customer experience (UX) - view video (~30 min) or download

✨ Features

Current Features

• Supports Single-Store and Multi-Store / Multi-Vendor / Peer-to-Peer / Digital Marketplaces
• Everything Reactive, Real-Time, and Blazing Fast!
• Headless Commerce framework, which allows different implementations of store-fronts, Admin UIs, and client apps. It exposes rich GraphQL, REST, and WS APIs.
• Mobile ordering App for customers to make On-Demand orders (Hybrid / PWA, iOS and Android using Ionic / Ionic Native)
• Carrier (Driver) Mobile App for deliveries by carriers, drivers, or service providers (iOS and Android using Ionic / Ionic Native)
• Customizing Shopping e-commerce Website for customers to make in-browser On-Demand purchases of food, goods or services
• Merchant Tablet App for Stores/Merchants/Warehouses to manage & track orders, organize deliveries, etc.
• Admin Website used to manage all platform features and settings in the single Web-based interface
• Multi-language and culture settings across Platform (i18N)
• Product catalogs (global and per Merchant) with Multiple Product Images
• Inventory/Stock Management and Real-time Order Management/Processing across the Platform
• Deliveries/Shipping management and processing across the Platform (shipping with real-time location tracking for On-Demand orders)
• Real-time discounts, promotions, and product/service availability updates
• Customer registration, Guest Checkouts, Invitations (optional)
• Gateway and Payment Processing (currently supported Payments Gateway - Stripe)
• Plugins / Extensions / Custom Fields (WIP)

Planned Features

• Tax Calculations
• Third-party Shipping provider integrations
• User Roles / Permissions across Platform
• Large product catalogs with product variants, facets, and full-text search

You can also track feature requests from the community in the separate repo.

Disclaimer

A word of caution: We are in α (alpha), i.e. Ever® Platform™ is very much under development (work in progress, WIP). Expect lots of changes and some :bug: and please be nice! :stuck_out_tongue_winking_eye:

🧱 Technology Stack and Requirements

• Full-stack TypeScript - frontends and NodeJs/Nest backend.
• Headless Commerce framework (Backend APIs/Server) developed using Nest. Supports GraphQL, REST and WS Real-Time APIs (WebSockets using Socket.io library).
• Ionic (version 5) for Carrier Mobile App and Merchant Tablet App.
• Shopping Mobile App built with Ionic (version 5).
• Shopping Mobile App built with React Native using Expo (WIP).
• Shopping Mobile App built with Flutter / Dart (WIP).
• Shopping Website developed with Angular (version 9.1) using Angular Starter.
• Admin Website developed with Angular (version 9.1) using ngx-admin.
• RxJS library used heavily in every part of the Platform.
• InversifyJS used for Inversion Control / Dependency Injection in most parts of the Platform. On the Backend/API we also use DI provided by Nest.
• MongoDB Database used with Mongoose ORM (supported MongoDB version >= 3.2; we recommend version >=4).
• We have an ongoing effort (WIP) to add support for other databases using TypeORM and Prisma. The following additional DBs will be fully supported: MySQL, PostgreSQL, MariaDB, SQLite, MS SQL Server, and Oracle.
• For production, we integrate and recommend using PM2.

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.

📄 Documentation

Please refer to our official Platform Documentation and to our Wiki (WIP).

For 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 for Server (Backend) related overview.

📊 Activity

🚀 Getting Started

We follow Gitflow Workflow, so the develop branch may be in an unstable or even broken state during development. Please use releases or master branch instead of the develop branch in order to get more stable code.

Clone Repo

Clone the Ever Platform Git repo:

git clone https://github.com/ever-co/ever-demand.git

IMPORTANT NOTE:

• If you want to use a develop branch (unstable, but latest development) clone using --branch develop (our default branch).
• If you want to use a release branch (more stable) clone use --branch master.

Yarn

Currently, we are using Yarn (instead of npm), so make sure you have the latest Yarn version installed before running Ever Platform:

npm install -g yarn@latest

Quick installation

After this GitHub repo is cloned, just run the following command to install/bootstrap all dependencies:

yarn bootstrap

The above command installs the required packages in all Platform projects using Lerna.

Note: 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

Build

You can build all projects in Ever Platform using the single command below: