Sign in

1. Open the admin portal in your browser (for example https://api.taptosay.app). You land on the Sign in screen.
2. Type your Username and Password.
3. Click Sign in.
4. You land on the Dashboard. The tabs across the top are the ones you can use. As root you get Students, Teachers, Classrooms, Users, and Schools.

Create a district (ISD)

Districts come first. A school, teacher, or district admin all belong to one. TapToSay uses the official Texas (TEA) ISD codes, so you pick the district from a list instead of typing it.

1. Click Schools.
2. Find the Add a district (ISD) card.
3. Open the dropdown “ISD (by 6-digit code, from TEA data)” and pick the ISD. Want to preview its campuses first? The Look up campuses by ISD code card above it does that — type the 6-digit code, like 237904, and click Look up.
4. Click Add district. It shows up in the Current districts (ISDs) table with its code.

Create a school (campus)

1. On Schools, find the Add a school (campus) card.
2. Pick the District (ISD) the campus belongs to.
3. Under Campus (9-digit TEA code) in this ISD, pick the campus. The list loads from that district's TEA data.
4. Click Add school. It lands in the All schools table.

Create a district admin

District admins get an email invite and finish their own account.

1. Click Users.
2. In the Invite a user card, click Show to open the form.
3. Fill in Email and Full name.
4. Set Role to District admin.
5. A District (for district admins and teachers) dropdown appears. Pick the district this person will run.
6. Click Send invitation. It shows under Pending invitations.
7. They get an email with a registration link. If the email is slow, use the Copy link button next to the invite and send it yourself.

Create a teacher

1. On Users, open Invite a user (Show).
2. Fill in Email and Full name.
3. Set Role to Teacher.
4. Pick the District. A teacher's code is unique per district, so it's required here.
5. Optional: type a Teacher ID (numbers only) — the number she'll use on her tablet. Leave it blank to set it later.
6. Click Send invitation.

Create a parent

1. On Users, open Invite a user (Show).
2. Fill in Email and Full name.
3. Set Role to Parent.
4. Under Attach to tablet, pick the student's tablet. That links the parent to the student.
5. Click Send invitation.

Create a student (student tablet)

1. Click Students, then + Add student.
2. Pick the School.
3. Type a Student name (optional — it shows in dropdowns instead of the raw ID).
4. Type the Student ID (what you'll provision the tablet with).
5. Leave the Auth password as-is, or click ⟳ for a new one. This is the tablet's own sign-in code.
6. Leave Server URL as https://api.taptosay.app unless you're told otherwise.
7. Leave Personal / BYOD device unchecked for a school device.
8. Click Create tablet.
9. Open the student, click Show on the Provisioning QR card, and scan that code with the tablet.

Managing users (any role)

The Users tab has four cards: Active users, Inactive accounts, Pending invitations, and Invite a user.

• Edit someone's name, email, role, or district with Edit on their row.
• Delete removes the account plus their guardianships, tablet assignments, and pending invites.
• Inactive accounts lists accounts 30+ days old with no tablet linked. Delete them here with Delete (30d+).
• Pending invitations shows invites nobody has accepted yet. Copy link lets you share one again.

My account

Open the ☰ menu (top right), then My account. You can change your Name and your password. Username and Email are locked.

Sign in

1. Open the invite email and click the registration link. It opens Create account with your Invitation token already filled in.
2. Pick a Username and a Password (min 8 chars).
3. Click Create account. You're signed in at the Dashboard.
4. Next time, just use Sign in with your username and password.

Your tabs are Students, Teachers, Classrooms, Users, and Schools.

Add a school (campus)

Your district is fixed, so you only add campuses in your ISD.

1. Click Schools.
2. In Add a school (campus), the district is already set to yours.
3. Under Campus (9-digit TEA code) in this ISD, pick the campus.
4. Click Add school.

To remove one, click Delete in the All schools table. Schools with tablets on them won't delete.

Add a student (student tablet)

1. Click Students, then + Add student.
2. Pick the School (only your district's schools show).
3. Optional: type a Student name.
4. Type the Student ID.
5. Keep the generated Auth password, or click ⟳ for a new one.
6. Leave Server URL as https://api.taptosay.app.
7. Leave Personal / BYOD device unchecked for a school device. Check it for a family's own device — its Exit PIN stays 2580.
8. Click Create tablet.
9. Open the student and use Provisioning QR → Show to set up the tablet.

Invite a teacher

1. Click Users, then Invite a user (Show).
2. Fill in Email and Full name.
3. Set Role to Teacher.
4. Optional: type a numbers-only Teacher ID.
5. Click Send invitation. The teacher lands in your district automatically.

Invite a parent and link them to a student

1. On Users, open Invite a user.
2. Fill in Email and Full name.
3. Set Role to Parent.
4. Under Attach to tablet, pick the student's tablet.
5. Click Send invitation.

Already have the parent's account? Link them from the student's page instead: open the student, then Teachers & parents (access) → Parents (guardians), pick the parent, and click Assign parent.

Create a classroom

1. Click Classrooms, then + New classroom.
2. Pick the School.
3. Optional: Assign to teacher so it shows on that teacher's tablet right away.
4. Optional: give it a Classroom name, like “Mrs. Smith — Room 12”.
5. Leave Server URL as https://api.taptosay.app.
6. Click Create classroom. It gets a class code like C12345.
7. Add students under the Students card: pick one from the dropdown, then click Add student by name.
8. Optional: assign teachers under Teachers with Assign teacher.

Manage a student

Open any student from Students. There you can:

• Details — change school, name, student ID, auth password (⟳ to regenerate), and server URL; click Save details.
• Teachers & parents (access) — add or remove the teachers and parents linked to the student.
• Provisioning QR — click Show for the tablet setup code.
• Passcodes — edit Settings PIN and Exit PIN, tick This is a personal / BYOD device; click Save passcodes.
• Vocabulary — edit the student's word board (see the Vocabulary chapter).
• Danger zone — Delete this tablet.

My account

☰ → My account to change your Name or password.

Sign in

1. Open the invite email and click the registration link.
2. On Create account, the Invitation token is already filled in. Pick a Username and Password (min 8 chars).
3. Click Create account.

Your tabs are Students, Teachers, and Classrooms.

View your students

1. Click Students. You'll see Name, ID, School, Settings PIN, Exit PIN, and Last sync.
2. Click a student to open their page. You can look at their details, their vocabulary, and who's linked to them — but you can't change passcodes.

Create a student

You know your students and their IDs, so you add them yourself. A student you create is automatically yours — it shows up in your Students list and can be dropped straight into one of your classrooms.

1. Click Students, then + Add student.
2. Pick the School.
3. Optional: type the Student name (it shows in dropdowns instead of the ID).
4. Type the Student ID — this is the number on the student's tablet.
5. The Auth password is filled in for you. Keep it or click ⟳ for a new one.
6. Leave Server URL as https://api.taptosay.app.
7. Click Create tablet. The student appears in your list right away.

Set up a classroom

A classroom loads every student in the room onto one tablet. The teacher switches students from a dropdown on the board.

1. Click Classrooms, then + New classroom.
2. Pick the School.
3. Optional: give it a Classroom name (shows in the list and on the board).
4. Leave Server URL as https://api.taptosay.app.
5. Click Create classroom. It gets a code like C12345 and opens the classroom page.

Link students to a classroom

1. On the classroom page, find the Students card.
2. Pick a student from the dropdown (they show by name; the ID is stored behind the scenes) and click Add student by name.
3. Repeat for each student. The count next to Students updates as you go.
4. To unlink someone, click Remove on their row — that takes them out of the classroom, not off the tablet.

Invite a parent

1. Click Users, then Invite a user (Show).
2. Fill in Email and Full name.
3. Set Role to Parent.
4. Under Attach to tablet, pick one of your students' tablets.
5. Click Send invitation. The parent gets linked to that student when they register.

Edit a student's vocabulary

1. Click Students and open the student.
2. Scroll to the Vocabulary card.
3. Rename a word, change a face, or add/remove items. Full walkthrough is in the Vocabulary chapter.
4. Click Save vocabulary (top or bottom of the card) to push it to the tablet.

My account

☰ → My account to change your Name or password.

Sign in

1. Open the invite email from your child's school and click the registration link.
2. On Create account, the Invitation token is already filled in. Pick a Username and Password (min 8 chars).
3. Click Create account. You're linked to your child automatically.
4. Next time, sign in with your username and password.

Your tabs are Students and Teachers. You won't see Users, Schools, or Classrooms.

What you can do

• See your child's page. Click Students, then your child. You can view their details and vocabulary.
• Edit your child's vocabulary. On the Vocabulary card, change words and faces, then click Save vocabulary. Your edits are yours — they never touch another student.
• Invite a co-guardian. On Users, invite another Parent. Under Share scope, choose All my tablets or One tablet, then send it. They get the same access you have.

What you can't do

My account

☰ → My account to change your Name or password.

How a vocabulary is built

• Categories are the top-level buttons — Food, People, Feelings.
• Sayings are the words inside a category — inside Food: apple, milk, cracker.
• A saying can hold sub-items, so a button can open up to more choices.
• Every button has a face: an Emoji, an AAC Symbol picture, or a custom Photo.
• Every button has a colour too. New items get one automatically so the board stays colourful.

Open the vocabulary editor

1. Click Students and open a student.
2. Scroll to the Vocabulary card. The board shows as an indented tree.
3. Make your edits (below), then click Save vocabulary — there's a button at the top of the card and another at the bottom.

Each row has a face button on the left, a text box with the label, a + (Add child), and a − (Remove). Under the last item in a list there's a + Add sibling row.

Rename a word

1. Click the text box and type the new label.
2. Click Save vocabulary.

Change a button's face (Emoji / Symbol / Photo)

Click the face button on the row — the one showing the current emoji, symbol, or photo. The Choose face window opens with three tabs. Pick the kind of face you want:

Your pick previews at the bottom of the window. Click Apply to use it, or Clear face to wipe it. Then click Save vocabulary to send the change to the tablet.

Cropping a photo

1. After you pick a photo, a square crop box shows up. Drag to move the picture, and scroll or pinch (or use the Zoom slider) to zoom.
2. When it looks right, click Use this photo. (Reset starts over.) The cropped square becomes the button's face.

Add or remove buttons

• Add a word inside a category: click + on the category row, then rename the new word and give it a face.
• Add a whole new category: click + on a category, then use the + Add sibling row under the last category (it starts as “New category”).
• Add a sub-item (drill-down): click + on a word row.
• Remove a button: click − on its row.

Modify an existing vocabulary

1. Open the student's Vocabulary card.
2. Rename, add, remove, or change faces as above.
3. Click Save vocabulary.
4. The tablet picks up the new board on its next sync.

How it fits together