Add persists code samples for ballerina bff

README.md

@@ -1 +1,46 @@
-# bff-samples
+## Ballerina Persists module with databases
+
+Ballerina's persistence features offer a straightforward way to work with data sources, making it easier to build an application's data access layer. By simply defining the required Ballerina records, the persistence package auto-generates all data access functions. This eliminates repetitive code, providing a simplified interface for inserting, updating and querying data with data tables directly mapped to Ballerina records.
+
+1. Clone the project 
+
+```
+$ git clone https://github.com/ballerina-guides/bff-samples.git
+```
+
+2. Install MySQL on the machine
+
+3. Add a new file `Config.toml` in the `/backend_server` directory and add the following configurations
+
+```
+[persists]
+host = "<Database Host>"
+port = <Database Port>
+user = <Username of MySQL user>
+password = <Password of MySQL user>
+database = <database name>
+```
+
+4. Run the following SQL query to create a new database in the MySQL server.
+
+```
+CREATE DATABASE <database name>;
+```
+
+5. Run the SQL scripts `backend_server/generated/script.sql` and `backend_server/resources/init-data.sql` to create the tables and insert data into the tables in the MySQL database.
+
+6. Open a new Terminal in the project path and run the Ballerina Server
+
+```
+$ cd bff-samples
+$ cd persists/backend_server
+$ bal run
+```
+
+4. Then open a new terminal in the project path and run the React server
+
+```
+$ cd bff-samples
+$ cd persists/frontend_server
+$ npm run dev
+```

persists/backend_server/.devcontainer.json

@@ -0,0 +1,4 @@
+{
+    "image": "ballerina/ballerina-devcontainer:2201.6.0",
+    "extensions": ["WSO2.ballerina"],
+}

persists/backend_server/.gitignore

@@ -0,0 +1,2 @@
+target
+Config.toml

persists/backend_server/Ballerina.toml

@@ -0,0 +1,17 @@
+[package]
+org = "bff_samples"
+name = "persists"
+version = "0.1.0"
+distribution = "2201.8.2"
+
+[build-options]
+observabilityIncluded = true
+
+[persist]
+datastore = "mysql"
+module = "persists"
+
+[[platform.java17.dependency]]
+groupId = "io.ballerina.stdlib"
+artifactId = "persist.sql-native"
+version = "1.2.0"