Skip to main content
Setting up a repository prepares it to run in a remote sandbox with your agent. This involves connecting GitHub, configuring environment variables, and setting up preview ports. When you first new Niteshift, we’ll run a guided setup flow to help you setup your environment. You can re-run this automated setup at any point from the respository settings page.

​
What setup involves

StepPurpose
GitHub AppGrant Niteshift access to your repositories
Repository setupClone, install dependencies, configure the environment
Environment variablesAdd secrets your repository needs to run
Preview portsExpose running services with public URLs

​
Quick path

If you just want to start using Niteshift:
  1. Install the GitHub App during onboarding
  2. Create a task—setup happens automatically
The agent clones your repository, detects your package manager, installs dependencies, and starts working.

​
Full setup

For repositories with specific requirements:
  1. Add environment variables in repository settings
  2. Configure preview ports for your dev server
  3. Optionally run guided setup to customize the environment
Guided setup asks questions about your project and configures the sandbox environment accordingly.