Getting Started
This guide walks through the typical first-run workflow in ArchNGN — from getting an account, through setting up your workspace and integrations, to running your first automation.
1. Get Account Access
Section titled “1. Get Account Access”ArchNGN is currently available by invitation. Visit app.archngn.com and select Request Access, or contact info@archngn.com to request access directly. Once an administrator approves your request, sign in with Google, GitHub, or email and password.
→ Full details: Account
2. Create a Workspace
Section titled “2. Create a Workspace”After signing in, head to Workspaces in the left sidebar and click Create Workspace. Give it a name and optional description — your new workspace is ready to use immediately. Use the Workspace Selector in the top-right corner to switch between workspaces; all platform features operate within the active workspace context.
→ Full details: Workspace
3. Set Up Integrations
Section titled “3. Set Up Integrations”Connect ArchNGN to the external systems that already hold metadata about your landscape. From Integrations, click Create Integration, choose the type (e.g., GitHub), provide credentials, and configure the scope. Run the integration to sync objects and associations into the active workspace.
→ Full details: Integrations
4. Work with Objects and Associations
Section titled “4. Work with Objects and Associations”Navigate to the Registry to browse what has been ingested. Create objects directly to fill gaps, edit metadata to add ownership and lifecycle information, and define associations to capture how systems relate. Associations are the edges in your dependency graph — they power impact analysis, lineage views, and standard reports.
→ Full details: Objects and Associations
5. Navigate the Application
Section titled “5. Navigate the Application”The platform is organised around a left sidebar for global navigation — Home, Workspaces, Registry, Explorer, Automations, Jobs, Reports, Metamodel, Integrations, Users, and Settings. The top-right of the screen holds the Workspace Selector and your User Profile (personal settings, region, token usage).
| Element | Location | Description |
|---|---|---|
| Global Navigation | Left sidebar | All platform features |
| Workspace Selector | Top right | Switch active workspace |
| User Profile | Top right | Personal settings and token usage |
6. Generate Automations
Section titled “6. Generate Automations”Once you have some objects in place, run an Automation to accelerate the work. Choose an automation type — New Design, Reverse Engineer, Forward Engineer, or Design Review — upload supporting documents or URLs, and select context objects from the Registry. The automation runs as a background job and produces diagrams, extracted objects, assessment summaries, and downloadable documents.
→ Full details: Automations