Note:GenAlpha Schematics will never, for any reason, no matter what, send your design data to GitHub, or anywhere else outside your own servers.
GitHub is used solely for user authentication and access validation.
Opening a Schematic or Symbol
With a database configured, just open the sch.oa or symbol.oa file in VsCode's file explorer.
Or run code {path}/{to}/sch.oa from the command line.
Setting up a Database
Configuring a database requires two primary pieces of information:
The library definitions. Each OpenAccess library has an associated directory on disk. Mappings from library-names to directories are dictated in a text format file defined by OpenAccess. By convention they have the filename lib.defs, although some popular programs will call them cds.lib.
Any environment variables required by the library definitions file. (They usually do depend on environment variables.)
Environment variables can be defined in either of two formats:
The popular dotenv format, supported by libraries such as python-dotenv and the original (JS) dotenv itself.
JSON, in the format { "VAR_NAME": "VAR_VALUE" }.
GenAlpha will attempt to auto-configure a database from your VsCode workspace directory. It will search for both library-definitions and environment variables starting in the workspace root, and then in each parent directory until it reaches the filesystem root.
Library definition files named either lib.defs or cds.lib will be auto-loaded.
If your library definitions are in any other path, run the GenAlpha: Set Library Definitions VsCode command and select their file.
Environment variable files named either .env (in dotenv format) or env.json (in JSON format) will be auto-loaded.
If your environment file is at any other path, run the GenAlpha: Set Environment File VsCode command to select it.
After configuring a schematic database, GenAlpha will write a resolution-file name db.resolved.json in the workspace root. This file contains the absolute paths to the library definitions and environment variables files that were loaded. It will also often be the best source of debug information if you're having trouble getting a database to load. The resolution-file attempts to catalog any information (typically variable-values) that it needed, but couldn't find.
Note running the popular Unix env utility can, but often doesn't, produce output compatible with the dotenv file format. Particularly env often includes special characters (and whitespace) which is not escaped or quoted. If running env to produce a dotenv file, expect to have to do some manual editing. JSON encoding, particularly when written by popular libraries, should avoid this problem. For example the (two-line) Python script env.py will produce a JSON file compatible with GenAlpha: