diff --git a/README.md b/README.md
index 02636f45..92026b8d 100644
--- a/README.md
+++ b/README.md
@@ -1,307 +1,134 @@
-# ⭐️ Overview
+## What is Fleetbase?
-Fleetbase is an open-source modular platform designed for the efficient management and orchestration of logistics operations. It serves as both a powerful operational tool for businesses and a flexible foundation for developers. The platform's core is built around a collection of "extensions," which create a customizable framework capable of meeting a wide range of supply chain and logistics requirements.
-
-Each extension in Fleetbase is purposefully engineered to fulfill specific roles within the logistics ecosystem. Users have the freedom to create their own extensions, expanding the platform's ecosystem and ensuring its adaptability to various use cases. This extensible nature keeps Fleetbase at the forefront of addressing diverse logistical and supply chain needs now and in the future.
+Fleetbase is a modular logistics and supply chain operating system designed to streamline management, planning, optimization, and operational control across various sectors of the supply chain industry.
- 
+ 
-
+**Quickstart**
+
+```bash
+git clone git@github.com:fleetbase/fleetbase.git
+cd fleetbase
+docker-compose up -d
+docker exec -ti fleetbase-application-1 bash
+sh deploy.sh
+```
+
+## 📖 Table of contents
+
+ - [Features](-features)
+ - [Install](-install)
+ - [Roadmap](-roadmap)
+ - [Bugs and Feature Requests](-bugs-and--feature-requests)
+ - [Documentation](-documentation)
+ - [Contributing](-contributing)
+ - [Community](-community)
+ - [Creators](-creators)
+ - [License & Copyright](-license-and-copyright)
+
+## 📦 Features
+- **Extensible:** Build installable extensions and additional functionality directly into the OS via modular architecture.
+- **Developer Friendly:** RESTful API, socket, and webhooks to seamlessly integrate with external systems or develop custom applications.
+- **Native Apps:** Collection of open-source and native apps designed for operations and customer facing.
+- **Collaboration:** Dedicated chat and comments system for collaboration across your organization.
+- **Security:** Secure data encryption, adherence to industry-standard security practices, and a comprehensive dynamic Identity and Access Management (IAM) system.
+- **Telematics:** Integrate and connect to hardware devices and sensors to provide more feedback and visibility into operations.
+- **Internationalized:** Translate into multiple languages to accommodate diverse user bases and global operations.
+- **Framework:** PHP core built around logistics and supply chain abstractions to streamline extension development.
+- **Dynamic:** Configurable rules, flows and logic to enable automation and customization.
+- **UI/UX:** Clean, responsive user-friendly interface for efficient management and operations from desktop or mobile.
+- **Dashboards:** Create custom dashboards and widgets to get full visibility into operations.
+- **Scalability:** Uninterrupted growth with scalable infrastructure and design, capable of handling increasing data volume and user demand as your business expands.
+- **Continuous Improvements:** Commitment to continuous improvement, providing regular updates that seamlessly introduce optimizations, new features, and overall enhancements to the OS.
+- **Open Source:** Deploy it either on-premise or in the cloud according to your organization's needs and preferences.
+
+## 💾 Install
+Getting up and running with Fleetbase via Docker is the quickest and most straightforward way. If you’d like to use Fleetbase without docker read the [full install guide in the Fleetbase documentation](https://docs.fleetbase.io/install).
+Make sure you have both the latest versions of docker and docker-compose installed on your system.
-# 📖 Table of contents
+```bash
+git clone git@github.com:fleetbase/fleetbase.git
+cd fleetbase
+docker-compose up -d
+docker exec -ti fleetbase-application-1 bash
+sh deploy.sh
+```
- - [What's Included](#-whats-included)
- - [Getting Started](#-getting-started)
- - [Use Cases](#-use-cases)
- - [Installation](#-installation)
- - [Extensions](#-extensions)
- - [Apps](#-apps)
- - [Roadmap](#-roadmap)
- - [Bugs and Feature Requests](#-bugs-and--feature-requests)
- - [Documentation](#-documentation)
- - [Contributing](#-contributing)
- - [Community](#-community)
- - [Creators](#-creators)
- - [License & Copyright](#-license-and-copyright)
-
-# 📦 What's Included
-
-Fleetbase is more than just a platform; it's a versatile ecosystem carefully architected to empower developers and businesses alike. Fleetbase comes pre-installed with a few extensions that provide base functionality to get users and businesses started:
-
-
- -
- Console: Fleetbase's frontend console is built with Ember.js and Ember Engines, offering a modular and extensible design. This design allows the system to easily adapt and scale according to your evolving needs while simplifying the integration of new extensions. By leveraging the console's design, extensions can be seamlessly installed using their respective package managers, reducing complexity and integration time.
-
- -
- Fleetbase API: Fleetbase's backend API and framework are built with Laravel, providing a robust and flexible infrastructure for extension development and integration. The system efficiently manages complex data structures and transactions while seamlessly incorporating new extensions through package managers. We offer additional packages for developers to create custom extensions, enhancing the flexibility and extensibility of the Fleetbase ecosystem.
-
- -
- Extensions: Fleetbase is designed to provide immediate utility out-of-the-box. It comes pre-installed with several key extensions
-
- - FleetOps: FleetOps, our comprehensive fleet management extension, caters to all aspects of last-mile operations. Some of it's features include:
-
- -
- Real-time tracking for vehicles and assets, ensuring optimal operational efficiency.
-
- -
- Order creation and management, facilitating seamless transaction processing.
- Service rates management, helping maintain financial transparency and profitability.
-
- -
- Fleet management, providing a holistic view and control of your fleet.
-
- -
- Third-party vendor integrations, allowing you to consolidate your resources.
-
- -
- API & Webhooks that not only offer increased interconnectivity but also serve to facilitate integrations with other services and applications, making FleetOps a truly versatile solution.
-
-
-
- -
- Storefront: Storefront is an extension that delivers headless commerce functionality, ideal for businesses aspiring to develop on-demand stores or marketplaces. It aims to facilitate seamless transactions while focusing on providing an excellent user experience.
-
- - Dev Console: The Dev Console extension is a developer's toolbox, providing resources such as:
-
- -
- API keys management, ensuring secure interactions with the application programming interface.
-
- -
- Webhooks management, enabling real-time data exchanges.
-
- -
- Sockets management, facilitating bi-directional client-server communication.
-
- -
- Logs management, crucial for system monitoring and troubleshooting.
-
- -
- API events management, keeping a pulse on system communications.
-
-
-
-
-
-
-
-# 🏁 Getting Started
-
-Before you can get started with Fleetbase, you'll need to make sure you have the following prerequisites:
-
-
- -
- A computer running either Linux, Mac OS, or Windows
-
- - Docker installed
- - Git installed
- - If you want to try now, the cloud hosted version of Fleetbase available here.
-
-
-# 🚦 Use Cases
-
-Fleetbase's comprehensive suite of features and the modular design make it highly versatile, catering to a broad array of applications across different industries. Here are a few use cases:
-
- - Logistics and Supply Chain Management: Fleetbase could be employed by a logistics company to streamline its operations. Real-time tracking provided by FleetOps would help maintain visibility of fleet vehicles and assets at all times. This would ensure timely delivery, reduce operational inefficiencies, and enable proactive management of any logistical issues. Additionally, the order creation and management feature could be used to manage deliveries, pickups, and routing.
+### Accessing Fleetbase
+Once successfully installed and running you can then access the Fleetbase console on port 4200 and the API will be accessible from port 8000.
- - On-demand Delivery Services: On-demand services like food delivery or courier companies could utilize Fleetbase to manage their fleet of delivery agents. The real-time tracking functionality would help to optimize routes and ensure prompt deliveries, while the order creation and management system would efficiently handle incoming orders.
+Fleetbase Console: http://localhost:4200
+Fleetbase API: http://localhost:8000
+
+### Additional Configurations
+
+**CORS:** If you’re installing directly on a server you may need to add your IP address or domain to the `api/config/cors.php` file in the `allowed_hosts` array.
- - E-Commerce Platforms: E-commerce businesses could leverage Fleetbase to manage their backend logistics. The Storefront extension would enable seamless online transactions, while FleetOps could manage all aspects of the delivery process, ensuring a smooth shopping experience for the customers.
+**Routing:** Fleetbase ships with its own OSRM server hosted at `routing.fleetbase.io` but you’re able to use your own or any other OSRM compatible server. You can modify this in the `console/environments` directory by modifying the env file of the environment you’re deploying and setting the `OSRM_HOST` to the OSRM server for Fleetbase to use.
- - Ride-Hailing Services: Fleetbase could be a perfect fit for ride-hailing or car rental services. FleetOps would manage real-time tracking of vehicles, maintaining optimal vehicle utilization, while the API and Webhooks would facilitate integration with mobile apps to provide real-time updates to customers.
-
- - Third-party Logistics (3PL) Provider: A 3PL provider could use Fleetbase for comprehensive management of its services. From real-time tracking of cargo to managing service rates and integration with other vendors in the supply chain, Fleetbase could provide an all-in-one solution.
-
- - Developer Resource Management: Developers building complex, resource-intensive applications could benefit from Fleetbase's Dev Console. API keys and webhook management could streamline the secure interaction between different software components. At the same time, sockets, logs, and API events management tools would assist in maintaining, troubleshooting, and improving the system.
+**Services:** There are a few environment variables which need to be set for Fleetbase to function with full features. If you’re deploying with docker then it’s easiest to just create a `docker-compose.override.yml` and supply the environment variables in this file.
- - Public Transportation Systems: City transportation services could use Fleetbase to optimize their bus or subway operations. With FleetOps, they could have real-time tracking of their vehicles, ensuring that schedules are met promptly and delays are handled effectively. Moreover, service rates management could assist in setting and adjusting fares, while the API and Webhooks functionality could integrate with public apps to provide real-time updates to commuters about arrivals, delays, and route changes.
+```yaml
+version: “3.8”
+services:
+ application:
+ environment:
+ MAIL_MAILER: (ses, smtp, mailgun, postmark, sendgrid)
+ OSRM_HOST: https://routing.fleetbase.io
+ IPINFO_API_KEY:
+ GOOGLE_MAPS_API_KEY:
+ GOOGLE_MAPS_LOCALE: us
+ TWILIO_SID:
+ TWILIO_TOKEN:
+ TWILIO_FROM:
+ CONSOLE_HOST: http://localhost:4200
+```
- - Fleet Leasing Companies: Fleet leasing companies could employ Fleetbase to manage their vehicle assets and track their status in real time. From managing service rates to ensuring the best utilization of assets, FleetOps could provide a holistic solution. Moreover, the Storefront extension could be used to list available vehicles and manage online reservations seamlessly.
+You can learn more about full installation, and configuration in the [official documentation](https://docs.fleetbase.io).
- - Emergency Services: Emergency services like ambulance or firefighting departments could use Fleetbase to manage their operations. FleetOps would provide real-time tracking, ensuring that emergency vehicles are dispatched quickly and the fastest routes are chosen. In addition, the API and Webhooks functionality could allow integration with emergency call centers, ensuring a seamless flow of information and a swift response to emergencies.
-
+## 🛣️ Roadmap
+1. **Extensions Registry and Marketplace** ~ Allows users to publish and sell installable extensions on Fleetbase instances.
+2. **Inventory and Warehouse Management** ~ Pallet will be Fleetbase’s first official extension for WMS & Inventory.
+3. **Customer Facing Views** ~ Extensions will be able to create public/customer facing views tracking and management from outside of the console UI.
+4. **Binary Builds** ~ Run Fleetbase from a single binary.
+5. **Fleetbase CLI** ~ Official CLI for publishing and managing extensions, as well as scaffolding extensions.
+6. **Fleetbase for Desktop** ~ Desktop builds for OSX and Windows.
+7. **Custom Maps and Routing Engines** ~ Feature to enable easy integrations with custom maps and routing engines like Google Maps or Mapbox etc…
-Remember, these are just a few examples. Given the modular and extensible nature of Fleetbase, it can be customized and scaled to fit many other use cases across different industries.
-
-# 💾 Installation
-
-Getting Fleetbase up and running on your system using Docker and Docker-compose is straightforward. Please follow the steps below:
-
-### Prerequisites
-
-
-
-### Build and Run Fleetbase
-
-
- -
- Start the Docker daemon:
- Ensure the Docker daemon is running on your machine. You can either start Docker Desktop or either executed by running:
-
service docker start
-
- -
- Build the Docker containers:
-Use Docker Compose to build and run the necessary containers. In the root directory of the Fleetbase repository, run:
-
docker-compose up -d
-
-
-
-### Additional Steps
-
-
- - Fleetbase will try to find the current hostname or public IP address to whitelist in for CORS, but if this fails you will need to manually add your hostname or instance URL to
api/config/cors.php in the allowed_origins array. This will whitelist the console for CORS access to your instance backend.
-
- - 🛣 Routing! By default Fleetbase currently will use it's own routing engine which is hosted at https://routing.fleetbase.io, this routing engine only works for a few enabled countries which include USA, Canada, Belgium, Spain, Serbia, Taiwan, Malaysia, Singapore, Brunei, Mongolia, India, Ghana. We can enable more regions and countries upon request. There is a Roadmap item to allow users to easily change to any routing engine provider such as Mapbox, Google Maps, and other 3rd Party Routing services. Optionally, you can switch out Fleetase Routing engine with any OSRM compatible service such as OpenStreetMap by changing the console environment variable
OSRM_HOST which can be found in console/environments/*.env.
-
- - If you find any bugs or unexpected issues please post an issue to the repo or join our Discord.
-
-
-
-### Troubleshoot
-
-Have an issue with the installation, try a few of these workarounds.
-
-
- - Installer not working?
If you encounter issues with the web based installer use this workaround to get going.
-
- - Login to the application container.
-
docker exec -ti fleetbase-application-1 bash
-
- - Manually run the database setup and migrations.
-
php artisan mysql:createdb
-php artisan migrate:refresh --seed
-
- - After completing these steps you should be able to proceed with account creation.
-
-
-
-
-### Access Fleetbase
-
-Now that Fleetbase is up and running via Docker you can find the console and the API accessible:
-
-
- - Fleetbase Console:
http://localhost:4200
- - Fleetbase API:
http://localhost:8000
-
-
-# 🧩 Extensions
-
-Fleetbase extensions provide a powerful way to enhance and customize the functionality of Fleetbase to suit your specific needs. They are standalone modules that seamlessly integrate with Fleetbase's frontend and backend, allowing you to extend its capabilities.
-
-### What are Fleetbase Extensions?
-Fleetbase Extensions are built using both a backend PHP package and a frontend Ember Engine Addon. They are designed to blend seamlessly into the Fleetbase ecosystem, utilizing shared services, utilities, stylesheets, components, and template helpers.
-
-### How do Extensions Work?
-
- - Backend: The backend of an extension is developed as a PHP package. This package should utilize the composer package
fleetbase/core-api, which provides core API functionalities, making it easier to integrate your extension with Fleetbase's backend.
-
- - Engine: The frontend of an extension is built as an Ember Engine Addon. The Addon must require the packages
@fleetbase/ember-core and @fleetbase/ember-ui. The @fleetbase/ember-core package provides core services and utilities that help to align your extension with Fleetbase's frontend. The @fleetbase/ember-ui package, on the other hand, supplies all the stylesheets, components, and template helpers needed to design a Fleetbase extension that seamlessly matches the look and feel of the Fleetbase UI.
-
-
-### Building a Fleetbase Extension
-To create a Fleetbase extension, follow these steps:
-
-
- - Backend PHP Package Creation: Begin by creating a backend PHP package. Make sure to use the composer package
fleetbase/core-api to ensure smooth integration with Fleetbase's backend.
-
- - Frontend Ember Engine Addon: Next, you need to create the frontend of the extension using Ember Engine. Be sure to include the
@fleetbase/ember-core and @fleetbase/ember-ui packages. These packages provide necessary services, utilities, and design components for aligning your extension with Fleetbase's UI.
-
- - Integrate Your Extension: Once you have the backend and frontend ready, you can integrate your extension into Fleetbase by installing it via the respective package managers. In the future you will be able to publish your extension to the Fleetbase extensions repository making it available to all instances of Fleetbase with the ability to even sell your extension.
-
-
-With Fleetbase's modular architecture, you can develop your extensions to solve unique problems, enhance existing functionality, or add entirely new capabilities to your Fleetbase instance. This extensibility allows Fleetbase to adapt and evolve with your growing business needs.
-
-# 📱 Apps
-
-Fleetbase offers a few open sourced apps which are built on Fleetbase which can be cloned and customized. Every app is built so that the Fleetbase instance can be switched out whether on-premise install or cloud hosted.
-
-
- - Storefront App: Fleetbase based ecommerce/on-demand app for launching your very own shop or marketplace to Apple or Android playstore.
- - Navigator App: Fleetbase based driver app which can be used for drivers to manage and update order, additionally provides real time driver location which can be viewed in the Fleetbase Console.
-
-
-# 🛣 Roadmap
-
-
- - Open Source Extension Repository
- - 🌎 Internationalize
- - Multiple and Custom Routing Engine's in FleetOps
- - Identity & Access Management (IAM) Extension
- - Inventory and Warehouse Management Extension
- - Freight Forwarder Quote Parser/ System Extension
-
-
-# 🪲 Bugs and 💡 Feature Requests
+## 🪲 Bugs and 💡 Feature Requests
Have a bug or a feature request? Please check the issue tracker and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.
-# 📚 Documentation
-
-View and contribute to our Fleetbase Guide's and API Reference
-
-# 👨💻 Contributing
+## 👨💻 Contributing
Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.
-# 👥 Community
+## 👥 Community
Get updates on Fleetbase's development and chat with the project maintainers and community members by joining our Discord.
@@ -313,7 +140,7 @@ Get updates on Fleetbase's development and chat with the project maintainers and
See the Releases section of our GitHub project for changelogs for each release version of Fleetbase.
Release announcement posts on the official Fleetbase blog contain summaries of the most noteworthy changes made in each release.
-# Creators
+## Creators
Ronald A. Richardson- Co-founder & CTO
-
+