> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/tasks/text-task.md).

# Text or sketch task

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/tasks/text-task.md).
{% endhint %}

Create a task from a drawing or from large text instead of a photo. Both apps draw sketches on this screen.

* **Where:** iOS and Android: [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md), "Sketch" opens the drawing mode, "Text" the text mode
* **Who:** anyone who reached the camera; what Send does next depends on where the camera was opened (see Actions)
* **Feature:** [Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md)

The screen also adds sketches and text to existing tasks, checklists and planned tasks. This doc covers new tasks. The mode is fixed when the screen opens; there is no switch between drawing and text.

## Layout

**Drawing mode ("Sketch")**

* **Top bar:** back, then the drawing tools: a thin pen, a thick pen and an eraser.
* **Canvas:** a blank drawing area.
* **Bottom bar:** the name field "Task name" (asset registers: iOS "Asset Name", Android "Asset name") and the send button.

**Text mode ("Text")**

* **Top bar:** back, a character counter ("0/50"), and the send button.
* **Text area:** four lines; the first shows the placeholder "Enter Text". iOS opens the keyboard straight away.
* There is no name field; the text is the name.

An info button exists in both layouts but is hidden.

## Inputs

| Field               | Type                    | Required | Default           | Rules and messages                                                                                                                                                                                                                                                      |
| ------------------- | ----------------------- | -------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Drawing             | freehand                | no       | thin pen selected | Thin pen, thick pen, eraser                                                                                                                                                                                                                                             |
| Name (drawing mode) | text                    | no       | empty             | iOS stops at 255 characters and cuts longer pastes. Android has no limit, and its keyboard is the email keyboard. Left empty, the task is titled "Task name" ("Asset Name" iOS, "Asset name" Android)                                                                   |
| Text (text mode)    | four single-line fields | no       | empty             | 13 characters per line, 11 on the last line, 50 in all. Typing past a line's limit moves the last word to the next line and focus with it; deleting on an empty line returns to the one above. Autocorrect and suggestions are off. The counter shows the total, "N/50" |

Nothing is required: sending an empty canvas or empty text creates a blank task named "Task name".

## Actions

| Action                      | Who         | What happens                                                                                                                                                                                                                            | API  |
| --------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- |
| Thin pen, thick pen, eraser | anyone here | Picks the drawing tool                                                                                                                                                                                                                  | none |
| Back                        | anyone here | Returns to [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md); nothing is kept                                                                                                                                | none |
| Send                        | anyone here | Turns the canvas or the text into the task image (below) and moves on. iOS ignores taps for one second after a tap; Android disables Send until the image is saved, and shows "Something went wrong. Please try again." if saving fails | none |

**What Send builds**

* **Drawing mode:** the image is the drawing. The name comes from the name field. If nothing is drawn but a name is given, the name is also stored as the task's large text (`fLargeTextTitle`), so the task shows as a text task.
* **Text mode:** the image is the text, and the four lines joined with spaces become both the large text and the name.
* **Size:** iOS scales the image to fit 800×800 pixels; Android saves it at screen size.
* **Task type:** `enum_JobType` 205 for a sketch, 206 for large text ([`enum_JobType`](https://docs.snapfix.com/engineering-reference/db/tables/enum_jobtype.md)). iOS decides by whether the task ended up with large text; Android by the button used on the camera.

**After Send**

* **Started from Home** ("Snap", the "+" menu, the iOS quick action): opens [Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md). As on [Photo edit and name](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md), iOS already stores the image and its "Created task" chat item for upload at this point. The first task right after setup goes to [First task group](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/first-task.md) instead.
* **Started from a room or area:** iOS opens [Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md) as a sheet; on Android the room or area screen asks for the group ([Room tasks](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-tasks.md)).
* **Started inside a group:** the same steps as for a photo, see [Photo edit and name](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md). On iOS the [Tag your task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md#tag-your-task) step offers no AI suggestions for text and sketch tasks.

## States

* **Loading:** none.
* **Empty:** the blank canvas or empty lines.
* **Error:** Android: "Something went wrong. Please try again." when the image cannot be saved. iOS has no error state.
* **No permission:** none needed.
* **Offline (mobile):** works fully offline.

## Platform differences

* iOS draws the image at most 800×800 pixels; Android at screen size.
* The name field limit and keyboard differ (see Inputs).
* iOS picks the task type from the result, Android from the camera button.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/tasks/text-task.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
