# Awesomate SDK (@awesomate/sdk 0.27.0) > Build apps on your own Awesomate data. Sign your customers in, show them their records as they change, and let them act, with the rules about who sees what kept in your own database. The whole site as one file: https://hub.awesomate.ai/docs/sdk/llms-full.txt Sister docs: Awesomate MCP: https://hub.awesomate.ai/docs/mcp/llms.txt ## Start here - [Introduction](https://hub.awesomate.ai/docs/sdk/): Build apps on your own Awesomate data. Sign your customers in, show them their records as they change, and let them act, with the rules about who sees what kept in your own database. - [Quickstart](https://hub.awesomate.ai/docs/sdk/quickstart/): Sign a person in on a web page and show them their records, kept current as they change. About ten minutes, on the Pro plan. - [How access works](https://hub.awesomate.ai/docs/sdk/how-it-works/): Kinds, roles, rules, apps and keys, and why your code never has to keep one customer's records away from another's. ## Tutorial - [Build a customer portal](https://hub.awesomate.ai/docs/sdk/tutorial/customer-portal/): A portal for a plumbing business, step by step. Customers sign in, see their own jobs, message the team and accept a quote; staff see every job; both see each other typing and can talk to the business's agent. ## Guides - [Sign people in](https://hub.awesomate.ai/docs/sdk/guides/sign-in/): Email sign-in links for your app's people, no passwords. How the link, the session and sign-out work, in a browser and in a mobile app. - [Lists that keep themselves current](https://hub.awesomate.ai/docs/sdk/guides/live-lists/): live() gives a page the whole list at first, then again whenever a row in it changes, from anywhere, for exactly the rows the person may see. - [Let customers take an action](https://hub.awesomate.ai/docs/sdk/guides/customer-actions/): Let a customer accept their quote, or do one other specific thing their write rule would not allow, without letting them edit the record. - [Files and uploads](https://hub.awesomate.ai/docs/sdk/guides/files/): Let people attach files in your app, and read or write your account's Files from your server, with public addresses for anything you want shared. - [Tasks](https://hub.awesomate.ai/docs/sdk/guides/tasks/): Give someone on the account a task from your app's server or an n8n workflow, and see what is waiting on people, on the account's Tasks board. - [Who's here and typing](https://hub.awesomate.ai/docs/sdk/guides/who-is-here/): Show who else has a record open and who is typing, including the app's assistant while it writes a reply. Checked as each person, never stored. - [Talk by voice](https://hub.awesomate.ai/docs/sdk/guides/voice/): Let the people signed in to your app talk to one of your account's agents. It greets them by name and knows the recent records they can see, and nothing more. - [Ask by text](https://hub.awesomate.ai/docs/sdk/guides/ask/): A help box in your app that answers from the business's own content, with sources, as the person who is signed in. - [Let staff find a customer](https://hub.awesomate.ai/docs/sdk/guides/find-a-customer/): Let staff in your app search your customers by name or email and put a record under one, without customers ever seeing each other. - [The people in your apps](https://hub.awesomate.ai/docs/sdk/guides/app-people/): List, add, disable and change the role of the people who sign in to the account's own apps, from your server. - [Query rows](https://hub.awesomate.ai/docs/sdk/guides/queries/): Filter, sort and page through records with the same grammar on every client. Dates, time variables and what the hub assumed. - [Kinds and records](https://hub.awesomate.ai/docs/sdk/guides/kinds-and-records/): Define the tables an app keeps, write records with the server client, and choose which fields Claude, agents and the account's token may read. - [Saved queries and recipes](https://hub.awesomate.ai/docs/sdk/guides/saved-queries-and-recipes/): Name a query or a set of writes once, then run it by name from anywhere, with typed parameters. - [Numbers from your contacts](https://hub.awesomate.ai/docs/sdk/guides/metrics/): Count and add up the contact list for a dashboard: what it can be measured by, one figure over time, and grouped numbers. - [Bookings](https://hub.awesomate.ai/docs/sdk/guides/bookings/): Your own booking page for visitors who are not signed in, and staff screens for the business's own team. List what can be booked and when, book a time, and let customers cancel or move from the link in their email. - [Email series events](https://hub.awesomate.ai/docs/sdk/guides/email-series-events/): Tell Contacts that something happened to someone (a job paid, a quote sent) from your server or an n8n workflow, so the email series waiting for it start or stop. - [From your server or n8n](https://hub.awesomate.ai/docs/sdk/guides/server-and-n8n/): Give your app's own server, or an n8n workflow, a key of its own instead of the account's token. What it can do and how to call it. - [Knowledge from a server](https://hub.awesomate.ai/docs/sdk/guides/knowledge/): Ask the account's Knowledge Base for a cited answer, search it, and read Your numbers, from your own server or an n8n workflow. - [Your support desk](https://hub.awesomate.ai/docs/sdk/guides/support-desk/): Read the account's own support desk, the help inbox for its customers, from your server: how it stands, its tickets, and one ticket in full. Read only. - [Generated types](https://hub.awesomate.ai/docs/sdk/guides/generated-types/): Type every query, saved query and recipe from your own account's kinds, with one command. - [Your business details](https://hub.awesomate.ai/docs/sdk/guides/business-details/): Read what Awesomate knows about the business itself (name, what it does, voice, colours, how customers reach it), with where each detail came from. ## Reference - [App client (browser)](https://hub.awesomate.ai/docs/sdk/reference/app-client/): createAppClient() and every method on it: signing in, reading and writing as the signed-in person, live lists, who is here, voice. - [Server client](https://hub.awesomate.ai/docs/sdk/reference/server-client/): createClient() and every method on it: who the token is, queries, numbers, kinds and records, saved queries, write recipes, the business, bookings, files, tasks, app people, Knowledge and the support desk. - [Bookings client](https://hub.awesomate.ai/docs/sdk/reference/bookings-client/): createBookingsClient() and every method on it: what can be booked and when, booking, and the customer's own link. - [Errors](https://hub.awesomate.ai/docs/sdk/reference/errors/): AwesomateError, what each error code means, and which sentence to show the person. - [Types](https://hub.awesomate.ai/docs/sdk/reference/types/): Every type @awesomate/sdk exports: query options, pages, app users, live updates, kinds, saved queries and recipes. ## Resources - [Changelog](https://hub.awesomate.ai/docs/sdk/changelog/): What changed in each version of @awesomate/sdk.