#Connecting an existing repository to the Forge
To get started with the Forge, you connect the GitHub repository you want maintained. This works the same way as connecting GitHub anywhere else in OCNexus: you approve access, and you can see exactly what you are approving (see "Connecting your GitHub account").
Once connected, the Forge takes an initial look at your repository to understand its structure and the languages it is written in. This first pass is just to build a picture of your code — it does not change anything yet.
You choose which repository to connect, and you can disconnect at any time. Connecting a repository never means giving up control of it — your code stays yours, and every change is still approved by you.
#Connecting your GitHub account
OCNexus works through GitHub. GitHub is where your app's code lives and how you sign in, so connecting your GitHub account is what lets OCNexus build and update your app for you.
The first time you connect, GitHub asks you to approve access. Approve it so OCNexus can create your app's code and save changes as it works. You are always shown what you are approving.
If a build cannot save its changes, or you see a permissions or access error, your GitHub connection has usually expired or access was removed. Reconnecting and re-approving access fixes this in almost every case.
You stay in control: you can review or remove OCNexus's access to GitHub at any time from your GitHub account settings. If reconnecting does not clear the problem, contact support with your app name.
#Does my app work on phones and tablets?
Yes. The apps OCNexus builds run in a web browser, which means they work on a phone, a tablet, or a computer — anywhere with a browser and an internet connection. There is nothing for you or your users to download or install.
OCNexus builds apps that are made to look right and work well whether someone opens them on a small phone screen or a large monitor, so your customers get a clean experience on whatever device they are using.
When you share your app, you are sharing a simple link. Anyone you send it to can open it on their own device and start using it right away.
#Getting started: building your first app
Getting started is as simple as describing what you want. You do not need a spec, a wireframe, or any technical detail — just tell OCNexus, in plain English, what you would like your app to do.
Here is the whole flow: 1. Describe your idea in your own words. 2. Answer a few short questions so OCNexus understands exactly what you need. 3. Review a quick summary of what it is going to build. 4. Give the go-ahead, and OCNexus builds, tests, and ships it.
You can start small — a simple first version — and grow it from there. The best first idea is a real one you actually want, described the way you would explain it to a friend. OCNexus takes it from there.
#SSE Connection Issues — Live Progress Not Updating
OCNexus uses Server-Sent Events (SSE) to stream live pipeline progress to your browser. If the progress display is not updating, here is what to check.
**The run is still executing — SSE is display only:** An SSE disconnection does not stop the pipeline. The run continues in the backend. Refresh the page and check Runs for the current status before assuming anything is broken.
**Common causes of SSE disconnects:**
*Network interruption:* Any brief network blip will break the SSE stream. This is expected — SSE requires a persistent connection. Refresh to reconnect.
*Browser tab backgrounded:* Some browsers throttle or kill SSE connections for background tabs. Keep the OCNexus tab in focus during a run if you need live progress.
*Corporate proxy or firewall:* Some enterprise network configurations buffer or terminate long-lived HTTP connections, which breaks SSE. If you are on a corporate network and SSE never works, try on a different network to confirm. Contact your IT team about allowing persistent HTTP connections to uss-api.lumeniq.ai.
*Nginx / proxy timeout:* If OCNexus is deployed behind a proxy, the proxy may have a read timeout shorter than a long pipeline run. This is a configuration issue — contact support@ocnexus.dev if you believe this is the case.
**If SSE never works at all:** Try a different browser. If it works in one browser but not another, it is a browser extension or setting causing the issue (ad blockers, privacy extensions sometimes block SSE).
#Which repositories can I connect to the Forge?
The Forge works with a GitHub repository you already have. It does not need to be an app OCNexus originally built for you — an existing codebase from anywhere is a valid starting point.
Today, the Forge understands JavaScript/TypeScript and Python codebases, so it can find and fix issues in projects written in those languages. Support for additional languages is planned over time (see "What the Forge looks for in your code").
Not sure if your particular repository is a good fit? Contact support and describe your project, and we will let you know plainly whether the Forge is ready for it today.