> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luminicad.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Text Command

> Learn how to write effective text commands for better CAD modeling results

## Basic Principles

### Be Specific and Clear

<CodeGroup>
  ```text Not Effective ❌ theme={null}
  "Make a big hole"
  "Add some rounded corners"
  "Put it somewhere in the middle"
  ```

  ```text Effective ✅ theme={null}
  "Create a 20mm diameter hole"
  "Add 5mm fillets to all edges"
  "Center the hole on the top face"
  ```
</CodeGroup>

## Structure Your Commands

### 1. Start with the Main Shape

<CodeGroup>
  ```text Step 1 theme={null}
  "Create a rectangular block 100mm long, 50mm wide, and 30mm tall"
  ```

  ```text Step 2 theme={null}
  "Add a 15mm diameter hole through the center"
  ```

  ```text Step 3 theme={null}
  "Add 3mm fillets to all vertical edges"
  ```
</CodeGroup>

### 2. Use Clear Measurements

* Always specify units (mm, cm, degrees)
* Use decimal points for precision
* Include all necessary dimensions

## Common Patterns

### Location References

```text theme={null}
"from the center"
"from the edge"
"relative to the base"
"aligned with the front face"
```

### Geometric Relations

```text theme={null}
"perpendicular to"
"parallel with"
"tangent to"
"concentric with"
```

### Pattern Commands

```text theme={null}
"evenly spaced"
"distributed around"
"mirrored across"
"repeated every X mm"
```

## Tips for Complex Models

### Break Down into Steps

<CodeGroup>
  ```text Complex ❌ theme={null}
  "Create a flanged cylinder with 6 bolt holes and internal threads"
  ```

  ```text Step-by-Step ✅ theme={null}
  "1. Create a cylinder 50mm diameter and 100mm tall
   2. Add a flange 80mm diameter and 10mm thick at the base
   3. Create a 6mm hole 60mm from center
   4. Pattern this hole 6 times around the flange
   5. Add M6 internal threads to all holes"
  ```
</CodeGroup>

### Use Reference Points

* Start with clear origin points
* Reference existing features
* Use standard planes (front, top, right)

## Troubleshooting

### When Results Aren't Perfect

1. **Review Your Description**
   * Check measurements
   * Verify relationships
   * Look for ambiguous terms

2. **Common Fixes**
   * Add missing dimensions
   * Clarify relationships
   * Break into smaller steps

<Tip>
  Keep a note of commands that work well. You can reuse these patterns in future models.
</Tip>

## Examples by Complexity

### Simple Components

```text theme={null}
"Create a cylinder 30mm diameter and 50mm tall"
"Add a 2mm fillet to the top edge"
```

### Medium Complexity

```text theme={null}
"Create a rectangular plate 100x150mm and 5mm thick
Add 8mm holes in each corner, 10mm from the edges
Add a 50mm diameter center hole"
```

### Complex Assemblies

```text theme={null}
"1. Create base plate 200x200x10mm
 2. Add 4 mounting holes 8mm diameter, 20mm from corners
 3. Center a cylinder 80mm diameter, 100mm tall
 4. Add support ribs 5mm thick every 90 degrees
 5. Create a top flange 100mm diameter, 10mm thick"
```

## Best Practices Checklist

✅ Include all dimensions\
✅ Specify units\
✅ Use clear reference points\
✅ Break down complex shapes\
✅ Review before executing\
✅ Build step by step

<Note>
  Remember: The quality of your model depends on the clarity of your description. Take time to plan and structure your commands.
</Note>

<Tip>
  Start simple and add complexity gradually. It's easier to add features than to fix mistakes in complex models.
</Tip>