> For the complete documentation index, see [llms.txt](https://tyegah.gitbook.io/crossword-ios/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tyegah.gitbook.io/crossword-ios/running-the-crossword-project.md).

# Running The Crossword Project

Before you run the project on XCode, you must run the backend Laravel project locally on your computer or from your configured server.

Open the Crossword Laravel Project and go to ***env.example*** file. Fill the configuration info for your **DB Connection**, **APP URL** and **Firebase FCM Server key**. Rename the file into ***.env***

<figure><img src="https://1844968280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpsyTb0ynWHc6WZJ15EoW%2Fuploads%2FBZk2BJRUH3r0AaQTS6uV%2FScreenshot%202024-01-23%20at%2016.17.49.png?alt=media&amp;token=c78d24d4-6f14-4c49-a30a-e39e1b11c150" alt=""><figcaption></figcaption></figure>

From inside your Laravel Project root folder, open terminal and run this command:

```
php artisan migrate
```

After the migration, you can now run the Laravel project using this command below:

```
php artisan serve 
```

Or, if you want to build the iOS app on the iPhone while the Laravel project is on your local server, you can use this command:

`php artisan serve --host 0.0.0.0`

Once you configured all the things for the **Laravel** project, you can try building and running the project using **XCode**. For the first time running the project, it will be downloading all the packages needed from **Swift Package Manager**, and after they're done you should be able to run the project.&#x20;