Getting Started

Getting Started

This guide walks you through setting up Crodox and creating your first grammar template.

---

Step 1 — Sign In

1. Open the Crodox app at your organization's URL
2. Enter your email address and click Send login code
3. Check your inbox for the login code and enter it

---

Step 2 — Set Up Your Profile

After signing in, you land on the Github tab.

1. Enter a user name and click save
2. Click Re-link GitHub to connect your GitHub account
3. Sign in to GitHub Enterprise and Authorize the Crodox-DEV app

Once authorized, the page shows "GitHub account linked" with your GitHub username.

---

Step 3 — Create a Template

Switch to the Template tab. This is where you define your Crodox grammar.

You have three options:

Method	How
Paste from wiki	Copy an example definition (e.g., Angular, Python, T-SQL) into the text editor
Import	Click import to load a .crodox file
Write from scratch	Write your grammar directly in the editor using the Syntax Overview

Click save when done. The parser validates your template:

• Valid → The template is saved and ready to use
• Error → The parser shows an error message. Refer to the Syntax Overview and the grammar documentation to fix it

Tip: Use the Template Generator to generate a starter template for your language.

---

Step 4 — Create a Bubble

Switch to the Bubbles tab.

1. Enter a name for your bubble (e.g., Angular)
2. Click create

The bubble opens with your template linked. You can now select a repository to test against. After saving, Crodox begins parsing the repository using your grammar definition.

Note: Creation and parsing may take a few seconds. Performance will improve in the release version.

---

What's Next?

• Learn the grammar syntax: Syntax Overview
• Understand the building blocks: Objects, Sub-bodies, Variables
• See complete examples: Angular, Python, T-SQL
• Generate starter templates: Template Generator