Repository Configuration
The Repository Configuration tab is where you manage the Git repository connection SCAYLE uses to build and deploy your Storefront Application. It's set up during your first-time setup and can be updated later as your repository, credentials, or build layout changes.
Where to find it
Repository configuration lives in Hosting ➜ Settings ➜ Repository Configuration.
If you haven't yet connected a repository, go to Overview to make the initial connection - see Getting Started for the step-by-step walkthrough. Once connected, the Repository Configuration tab shows the current setup and lets you edit it.
What you see
The Repository Configuration tab displays:
- Provider - the Git hosting provider (GitHub, GitLab, or Other Git Repository), shown with a "Connected" status.
- Repository Name - the full path of the connected repository (e.g., your-org/storefront-app).
- Access Token - the authentication token used to clone and (when needed) push to the repository. Shown masked; the actual token cannot be retrieved after entry.
- Working Directory - the path within the repository where build commands run. Defaults to
.(the repository root). Used for monorepo support.
Editing the configuration
To update the existing repository configuration:
- Click Edit in the top right of the Repository Configuration card.
- Update the fields as needed - for example, rotate the access token, change the working directory, or update the repository path.
- Save your changes.
The next deployment will use the updated configuration.
Changing the provider
If you need to switch to a different Git provider, click Change Provider in the Repository Configuration card. You'll be taken back to the provider selection flow, where you can choose GitHub, GitLab, or Other Git Repository and provide the new connection details.
Changing providers replaces the existing connection. Make sure your new provider has the same codebase (or migrate it first) before changing the connection.
Working Directory (monorepo support)
If your Storefront Application lives in a subfolder of a monorepo, the Working Directory field tells SCAYLE where to run build commands. For example, if your monorepo layout is:
Set the Working Directory to the path of your Storefront Application within the repository (for example, apps/storefront). SCAYLE will run all build commands from that subfolder.
If your Storefront Application is at the root of the repository (the default for most setups), leave the Working Directory as ..
