There are 2 possible ways of installing DEITY Falcon (depends on what you want to do):
- Install DEITY Falcon within an example template (using
- Install DEITY Falcon sources to work on Falcon itself
Create Falcon App (CLI tool)
This CLI tool helps you to create your application based on DEITY Falcon with just one command.
Generate your app with:
then run the server app in one terminal:
and the client app in the second terminal:
then open http://localhost:3000 in your browser
How to generate application
You can use either npx (installed with npm) or yarn to generate the application.
If you prefer yarn use
yarn create with the syntax below (notice space between
Note: Please do not install the package globally
That command will create a
my-app folder with 2 folders inside:
server contains the server application which is responsible for communication with external APIs and services.
client contains the client application responsible for front-end rendering.
npx create-falcon-app my-app or
yarn create falcon-app my-app is done you can start both services. In one terminal window run the following commands to start the server part:
in the second terminal run the following commands to start the client part:
Selecting the template for your project during generation
Currently we provide just one template for the generator which delivers basic features of shop and blog (the template itself is called
In the future we'll provide more templates that can be selected with an
--example option. Full command that uses
shop-with-blog in that case will be as following:
You can also use
npx create-falcon-app -h (or
yarn create falcon-app -h) to get the list of the available templates and options.
Using your backend services
By default the
shop-with-blog example uses demo Magento 2 and WordPress servers provided by DEITY so you can check how DEITY Falcon works. If you cannot start the server part (from within the server folder) or you see any problems with server behavior please contact us via our community slack channel.
If you want to connect the generated app to your own Magento 2 backend you will need to install the Falcon Magento2 module which delivers REST endpoints required by DEITY Falcon and change the configuration file of your Falcon-Server to point the application to the correct url.
See Installing Magento 2 Module for more.
Also if you want to connect a DEITY Falcon application to your WordPress server, you'll have to install Falcon WordPress module and also change the configuration file of your Falcon-Server to point the application to the correct server.
See Installing Wordpress 2 Module for more.