diff --git a/README.md b/README.md
index 12470c3..3976f71 100644
--- a/README.md
+++ b/README.md
@@ -1,79 +1,80 @@
-This is a new [**React Native**](https://reactnative.dev) project, bootstrapped using [`@react-native-community/cli`](https://github.com/react-native-community/cli).
+
+ 
+
-# Getting Started
->**Note**: Make sure you have completed the [React Native - Environment Setup](https://reactnative.dev/docs/environment-setup) instructions till "Creating a new application" step, before proceeding.
+Stargazers Viewer App ⭐️
+
+
+ 
+
+
-## Step 1: Start the Metro Server
+[](https://sonarcloud.io/summary/new_code?id=LeleDallas_StargazersViewerApp)
+[](https://sonarcloud.io/summary/new_code?id=LeleDallas_StargazersViewerApp)
+[](https://sonarcloud.io/summary/new_code?id=LeleDallas_StargazersViewerApp)
+[](https://sonarcloud.io/summary/new_code?id=LeleDallas_StargazersViewerApp)
+[](https://sonarcloud.io/summary/new_code?id=LeleDallas_StargazersViewerApp)
+[](https://sonarcloud.io/summary/new_code?id=LeleDallas_StargazersViewerApp)
+[](https://sonarcloud.io/summary/new_code?id=LeleDallas_StargazersViewerApp)
+[](https://sonarcloud.io/summary/new_code?id=LeleDallas_StargazersViewerApp)
-First, you will need to start **Metro**, the JavaScript _bundler_ that ships _with_ React Native.
+
+ :book: Table of Contents
-To start Metro, run the following command from the _root_ of your React Native project:
+
+ Table of Contents
+
+ - ➤ About The Project
+ - ➤ Getting Started
+ - ➤ Authors
+
+
-```bash
-# using npm
-npm start
+
-# OR using Yarn
-yarn start
-```
+
+ :pencil: About The Project
-## Step 2: Start your Application
+
-Let Metro Bundler run in its _own_ terminal. Open a _new_ terminal from the _root_ of your React Native project. Run the following command to start your _Android_ or _iOS_ app:
+StarGazers Viewer App is a mobile application that allows you to search for a GitHub user and it's repository and view its stargazers.
+Built using React Native and TypeScript, the application uses the GitHub API with graphql to fetch the stargazers of a repository.
-### For Android
+
-```bash
-# using npm
-npm run android
+
-# OR using Yarn
-yarn android
-```
+
+ :book: Getting Started
-### For iOS
+Via GitHub Desktop clone this repository then to run the app, you need to have Node.js `v20.12.2` or higher installed on your system and Android Studio or XCode installed in your system.
-```bash
-# using npm
-npm run ios
+> [!WARNING]
+> To run this project locally you need to create an `.env` file in the root of the project directory with following variables:
+> ``` bash
+> API_URL = https://api.github.com
+> API_KEY = ${YOUR_GITHUB_TOKEN}
+> ```
+> You can create a personal Github token [here](https://github.com/settings/tokens?type=beta). Make sure to add `Read access to followers, starring, and watching` as permission.
-# OR using Yarn
-yarn ios
-```
+To run it locally, follow these steps:
-If everything is set up _correctly_, you should see your new app running in your _Android Emulator_ or _iOS Simulator_ shortly provided you have set up your emulator/simulator correctly.
+- Navigate to the project folder.
+- Run the command `npm install` to install all the necessary dependencies.
+- On ios, `cd ios && pod install && cd..`
+- Run the command `npx react-native start` to start the app. From the cli now select the system to run.
-This is one way to run your app — you can also run it directly from within Android Studio and Xcode respectively.
+The app will install in your emulator/device.
-## Step 3: Modifying your App
-Now that you have successfully run the app, let's modify it.
+
-1. Open `App.tsx` in your text editor of choice and edit some lines.
-2. For **Android**: Press the R key twice or select **"Reload"** from the **Developer Menu** (Ctrl + M (on Window and Linux) or Cmd ⌘ + M (on macOS)) to see your changes!
- For **iOS**: Hit Cmd ⌘ + R in your iOS Simulator to reload the app and see your changes!
+
+ :scroll: Authors
-## Congratulations! :tada:
+Emanuele Dall'Ara
-You've successfully run and modified your React Native App. :partying_face:
-
-### Now what?
-
-- If you want to add this new React Native code to an existing application, check out the [Integration guide](https://reactnative.dev/docs/integration-with-existing-apps).
-- If you're curious to learn more about React Native, check out the [Introduction to React Native](https://reactnative.dev/docs/getting-started).
-
-# Troubleshooting
-
-If you can't get this to work, see the [Troubleshooting](https://reactnative.dev/docs/troubleshooting) page.
-
-# Learn More
-
-To learn more about React Native, take a look at the following resources:
-
-- [React Native Website](https://reactnative.dev) - learn more about React Native.
-- [Getting Started](https://reactnative.dev/docs/environment-setup) - an **overview** of React Native and how setup your environment.
-- [Learn the Basics](https://reactnative.dev/docs/getting-started) - a **guided tour** of the React Native **basics**.
-- [Blog](https://reactnative.dev/blog) - read the latest official React Native **Blog** posts.
-- [`@facebook/react-native`](https://github.com/facebook/react-native) - the Open Source; GitHub **repository** for React Native.
+[](https://github.com/LeleDallas)
+[](https://www.linkedin.com/in/emanuele-dall-ara-40b3311a7/)