Skip to content

🏁 Getting Started

🧩 build.visualli.ai

What is it?

build.visualli.ai is a collaborative dev workspace that allows devs to work on Visualli.ai projects from anywhere in the world, without having to set up or configure their local development environment. All you need is a browser and an internet connection.

How?

  • Ensure your personal workspace is started first 👆.

  • Go to 👉 https://build.visualli.ai, login using your @visualli.ai creds.

  • Click on your workspace and Get Go! 🚀

NOTE: GitHub Copilot and other GitHub extensions are pre-configured.

Why?

  • Faster to get started, as we aspire devs to be able to commit, submit and merge their PRs on their day-1️⃣ without any friction.
  • OS and Version mismatch of dependencies between local and runtime environments is a common problem, and we want to avoid it worked on my machine problem by all means.

⬇️ Clone Repos

  • Open VS Code, and clone the following repositories as shown below:

    • visualli.ai - https://github.com/visualli-ai/visualli.ai

      Full-stack repo of Visualli.ai (frontend, backend, ai-engine, official website, etc)

    • wiki.visualli.ai - https://github.com/visualli-ai/wiki.visualli.ai

      Repo consists of the documentation for Visualli.ai (this wiki)

    • visualli-labs - https://github.com/visualli-ai/visualli-labs

      Repo consists of all the experimental stuff for Visualli.ai

  • Select Clone Repository -> Clone from GitHub

  • Click Allow

  • Choose visualli-bot if it appears

  • If visualli-bot does not appear above, then follow Sign in to GitHub, the username/password auto-fills itself

  • Check your @visualli.ai inbox for the verification code

  • Enter the verification code, Voila!

🔨 Repos, Branches & Workflow

Repo: visualli.ai

🔁 Branches

Branch Purpose URL Stability Audience
dev Developers’ playground https://dev.visualli.ai 🔴 Low Visualli crew
alpha Early access / bleeding edge https://alpha.visualli.ai 🟠 Medium Select userbase
beta Pre-release candidate 🟡 High Broad userbase
main Production release 🟢 Very high All users

⁕ Flow

  1. Create features & fixes:

    • From dev, create branches like:
      • feat/login-redesign
      • fix/image-upload-bug
      • chore/version-upgrade

  2. Merge frequently to dev (via PRs):

    • PR reviewed → merged into dev
    • dev always reflects "what we’re working on now"

  3. Promote to alpha regularly:

    • Merge dev → alpha (e.g., weekly or bi-weekly cadence)
    • Tag & deploy alpha versions (e.g., v1.3.0-alpha.1)

  4. Stabilize for beta:

    • Once features are tested in alpha, promote from alpha → beta
    • Tag & deploy beta versions (e.g., v1.3.0-beta.2)

  5. Cut main release:

    • After alpha and beta testing, merge beta → main
    • Tag & deploy production version (e.g., v1.3.0)

📦 Versioning

  • Use Semantic Versioning: v1.2.3-alpha.1, v1.2.3-beta.2, v1.2.3

Repo: visualli-labs

🔁 Branches

Branch Purpose URL Stability Audience
main Developers’ playground https://labs.visualli.ai 🔴 Low Visualli crew

⁕ Flow

  1. Direct push to main branch, no features / no branches needed.

  2. When you are ready to deploy it via labs.visualli.ai URL, follow the instructions inside README.md of this repository.

⤴️ Pull Requests

  • Follow the workflow as described above.
  • Submit your PR using the VS Code extensions (GitHub Pull Requests) as shown below