Deployments

Understanding automatic code deployment

NStrim automatically deploys your code every time you push to Git. This guide explains how the deployment system works and how to monitor your deployments.

How It Works

  1. You push code to your Git repository
  2. The system detects the push and starts building your project
  3. Your code is deployed to a live URL
  4. The deployment status is updated on your dashboard

Repository Mapping

When you create a repository from the dashboard, the deployment mapping is set up automatically — no extra steps needed.

Each repository you create is automatically mapped to a deployment URL via the subdomain you chose during creation. You can view and manage your mappings in the Tools & Deployment tab.

This entire process typically takes just a few seconds.

Your Deployment URL

Each student has a unique URL for viewing their deployed work. The format is:

https://<competitor-slug>-<module-name>.<session-domain>

For example, if your subdomain is ws01 and you're working on module-a:

https://asdfg-module-a.demo.nstrim.app

Deployment Status

Your dashboard shows the current status of your deployment:

Success Your code deployed successfully and is live
Building Deployment is in progress
Failed Deployment failed - check the error message

Common Deployment Issues

Build Errors

If your deployment fails, check for:

  • Syntax errors in your code
  • Missing dependencies
  • Incorrect file structure

404 Errors

If you see a 404 error when visiting your URL:

  • Verify your repository name matches the module name
  • Check that you've pushed your code
  • Wait a few seconds for the deployment to complete

Blank Page

If your page loads but is blank:

  • Check browser developer tools for JavaScript errors
  • Verify your HTML structure is correct
  • For PHP projects, check your server error logs

Tips for Successful Deployments

  • Test locally first — Always verify your code works before pushing
  • Check the status — After pushing, watch your dashboard for deployment status
  • View your deployment — Open your deployment URL to verify it works correctly
  • Don't panic on failures — Read the error message, fix the issue, and push again