==================
Tutorial
==================

To simplify the process of creating a new web application with a global backend, Beyond Vision has created a series of tutorials, that explain how to manage your organization, control your drones, and expose the user to a couple of APIs.

To get the most out of this tutorial, it is recommended to have a basic understanding of `Angular <https://angular.dev/>`_.

Let's jump right into it!

.. figure:: ../../_static/images/bexstream/tutorial/tutorial-sum.webp
    :name: tutorial
    :align: center
    :width: 80%

You can find each Tutorial Part in the following links:

.. toctree::
   :maxdepth: 1

   tutorial/setup.rst
   tutorial/part-i.rst
   tutorial/part-ii.rst
   tutorial/part-iii.rst
   tutorial/part-iv.rst
   tutorial/part-v.rst
   tutorial/part-vi.rst

A public reference implementation of this example can be found at https://github.com/BV-OpenSource/beXStream-tutorial.
Differences (of the reference implementation) from this tutorial are:

* To avoid `CORS <https://en.wikipedia.org/wiki/Cross-origin_resource_sharing>`_ issues, the reference implementation uses a proxy to forward requests to the backend ( https://angular.dev/tools/cli/serve#proxying-to-a-backend-server ). So instead of using an hardcoded URL like 'https://bexstream.beydond-vision.com/api/v1/auth/user', you will find a relative path like '/api/v1/auth/user', and, in angular.json you will find a proxyConfig option 'src/environment/proxy.conf.js' that relays the request to the desired backend URL.

* The reference implementation environment defaults to use beXStream's pre-production environment (https://bexstream-preprod.beyond-vision.com/). Contact `beyond-vision.com <https://beyond-vision.com>`_ to ask for an evaluation account (organization, username and password) and a drone-simulator so that you can test the reference application.

These are just a couple of examples of the overall possibilities that can be developed on top of the multiple APIs exposed by the beXStream platform (https://docs.beyond-vision.com/bexstream/APIs.html ).