How to install Breadly (Custom Back-end for AppInventor)

yanquisalexander · November 10, 2019, 1:43pm

Hello everyone!

This is my first guide here, today I will teach you how to install Breadly, a Back-end for AppInventor applications (Although it can perfectly be used in WebApps or other applications)

Requirements

Since it is based on Laravel, it has pretty much the same requirements:

PHP >= 7.1.0

OpenSSL PHP Extension

PDO PHP Extension

Mbstring PHP Extension

Tokenizer PHP Extension

XML PHP Extension

Ok, assuming you already have the aforementioned requirements, proceed with the installation

Local Installation

For local development you must install an additional program (XAMPP, Laragon or WAMP)

For this guide I will use Laragon (I recommend the Full version)

In my case the installation of Laragon has installed the requirements, but check after installation

Laragon Installation

Once installed proceed to part 2

phpMyAdmin

By default phpMyAdmin is not installed next to Laragon, but it is easily installable by following these simple steps:

Menu > Tools > Quick add > phpMyAdmin

Once installed you must restart Laragon to apply the changes

Creating Database

Go to http://localhost/phpmyadmin

By default the user is root, does not have a password

Once you access you must create an exclusive database for Breadly

Opera%20Captura%20de%20pantalla_2019-11-10_100807_localhost

So far so good (I guess)

Cloning Breadly

From now on we will use the Terminal, so you must be careful

Open Laragon Terminal

Captura

Once opened you must write the following commands (In restricted order)

cd C:\laragon\www && git clone GitHub - avramovic/breadly: The missing backend for App Inventor applications

cd breadly

cp .env.example .env && nano .env

At this point you must modify the APP_URL (http://localhost/breadly in this case) and DB_DATABASE lines, you must leave DB_USERNAME in “root” and DB_PASSWORD empty

To save you must press CTRL + O, press enter and then CTRL + X

composer install

php artisan key:generate

php artisan migrate --seed

If everything goes well, a login screen will appear when accessing http://localhost/breadly/admin

Extra information

Default credentials:

[email protected] | password

Breadly is based on Voyager, so you can find documentation to customize here: https://voyager.devdojo.com

REST Api Use

yanquisalexander · November 10, 2019, 2:05pm

I made this topic short of time, so if you have any questions, let me know

In a few days I will place the instructions to install on a hosting server

ImranTariq · November 10, 2019, 2:20pm

Awesome work, Will help many Users, and asked by many also,

vknow360 · November 11, 2019, 1:57am

It’s really amazing…
Waiting for setup on Web Server

yanquisalexander · November 12, 2019, 9:41am

Hello everyone!

I am trying to install Breadly on AWS, if it works later I will publish instructions to implement Breadly on AWS

parmarparth996 · November 18, 2019, 11:36am

it’s not /admin it is public/admin

parmarparth996 · November 18, 2019, 11:43am

Expected response code 250 but got code \"530\", with message \"530 5.7.1 Authentication required\r\n\""

i got this error when regisater

yanquisalexander · November 18, 2019, 2:09pm

You must restart Laragon

parmarparth996 · November 18, 2019, 2:43pm

I am not on laragon I am using xammp and I restarted it

parmarparth996 · November 18, 2019, 2:43pm

This comes when I try to register new user from API with code given on postman docs

yanquisalexander · November 18, 2019, 2:57pm

It is more advisable to use Laragon

The problem with the registration is due to the lack of mail server data

I will add it later to the main post

parmarparth996 · November 18, 2019, 3:12pm

What about this

avramyu · December 11, 2019, 11:35pm

Hello everyone,

Nice to see someone is actually using Breadly (Thunkable classic is dead)

The document root should be YOUR_BREADLY_FOLDER/public, so it’s going to be only http://localhost/admin. XAMPP is not best to use Laravel apps but it can be made to work. Using virtualhost with custom document root might be your best option,

Feel free to ask me anything related to Breadly, I’d be happy to help!

yanquisalexander · December 11, 2019, 11:57pm

I am using Laragon, and it automatically creates a .test “domain”

https://mybreadlypanel.test for example

(Yes, https because it also installs an SSL certificate for that virtual domain)

avramyu · December 11, 2019, 11:58pm

Not sure where are you getting this error message? Neither 250 nor 530 are valid HTTP response codes so I’m nor sure this is coming from Breadly. Can you provide more info about what are you exactly trying to do?

yanquisalexander · December 12, 2019, 12:06am

I think I know why it is

SMTP is not configured in the .env file, I will add that to the main post

avramyu · December 12, 2019, 12:32am

You can also turn off email activation in Settings / Site (in /admin)

a5artilary · May 30, 2020, 6:20am

Hello, I wanted to reinstall breadly because I changed column name and it stopped updating the specific table data.

avramyu · May 30, 2020, 1:58pm

You don’t need to reinstall whole Breadly, you can reinstall the database only by issuing the following command:

php artisan migrate:refresh --seed

edit: it WILL destroy all your data in the database and set up a new, empty one

a5artilary · May 31, 2020, 5:50am

There is no option to sync with main database?

What if I want to remove breadly? (command)