diff --git a/app/entities/page.mdx b/app/entities/page.mdx
index e69de29..ae6d366 100644
--- a/app/entities/page.mdx
+++ b/app/entities/page.mdx
@@ -0,0 +1,83 @@
+export const metadata = {
+ title: 'Entities',
+ description:
+ 'Entities are simple JSON objects that represent the core data structures in Lysand.',
+}
+
+# Entities
+
+Entities are the foundation of the Lysand protocol. A similar concept to entities are the [ActivityStreams](https://www.w3.org/TR/activitystreams-core/) objects, which are used to represent activities in the [ActivityPub](https://www.w3.org/TR/activitypub/) protocol. {{ className: 'lead' }}
+
+## Entity Definition
+
+An entity is a simple JSON object that represents a core data structure in Lysand. Entities are used to represent various types of data, such as users, notes, and more. Each entity has a unique `id` property that is used to identify it within the instance.
+
+Any field in an entity not marked as `required` may be omitted or set to `null`.
+
+
+
+
+
+
+ Unique identifier for the entity. Must be unique within the instance.
+
+ Must be a [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier). Any version of UUID is allowed.
+
+
+ Type of the entity. Only types defined in the Lysand protocol are allowed. Use an [Extension](/extensions) if you want to define custom types.
+
+
+ Date and time when the entity was created. Must be an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) formatted string.
+
+
+ Handling of dates that are valid but obviously incorrect (e.g. in the future) is left to the Implementation's discretion.
+
+
+
+ URI of the entity. Must `id`. Should be unique and resolve to the entity.
+
+
+ Extensions to the entity. Use this to add custom properties to the entity.
+
+ Each custom property must be namespaced with the organization's domain name, followed by the property name. Extensions should be used sparingly and only when necessary.
+
+
+
+
+
+ ```jsonc {{ 'title': 'Example Entity' }}
+ {
+ "id": "9a8928b6-2526-4979-aab1-ef2f88cd5700",
+ "type": "Freeze",
+ "created_at": "2022-01-01T12:00:00Z",
+ "uri": "https://bongo.social/notes/9a8928b6-2526-4979-aab1-ef2f88cd5700",
+ }
+ ```
+
+ ```jsonc {{ 'title': 'With Extensions' }}
+ {
+ "id": "f0aacf0b-df7a-4ee5-a2ba-6c4acafd8642",
+ "type": "Zlorb",
+ "created_at": "2023-04-13T08:00:00Z",
+ "uri": "https://space.org/zlorbs/f0aacf0b-df7a-4ee5-a2ba-6c4acafd8642",
+ "extensions": { // [!code focus:100]
+ "org.space:zlorbs": {
+ "zlorb_type": "giant",
+ "zlorb_size": "huge"
+ },
+ "org.lysand:location": {
+ "latitude": 37.7749,
+ "longitude": -122.4194
+ }
+ }
+ }
+ ```
+
+
+
+## Serialization
+
+When serialized to a string, the JSON representation of an entity should follow the following rules:
+- Keys must be sorted lexicographically.
+- Should use UTF-8 encoding.
+- Must be **signed** using the relevant [User](/entities/users)'s private key, or the [Server Actor](/entities/server-actor)'s private key if the entity is not associated with a particular user.
\ No newline at end of file
diff --git a/app/entities/users/page.mdx b/app/entities/users/page.mdx
index 16331c6..0e32b8a 100644
--- a/app/entities/users/page.mdx
+++ b/app/entities/users/page.mdx
@@ -58,25 +58,25 @@ The `User` entity represents an account on a Lysand instance. Users can post [No
User consent to be indexed by search engines. If `false`, the user's profile should not be indexed.
-
+
The user's federation inbox. Refer to the [federation documentation](/federation).
-
+
The user's federation outbox. Refer to the [federation documentation](/federation).
-
+
User's followers. URI must resolve to a [Collection](/structures/collection) of [User](/entities/users) entities.
-
+
Users that the user follows. URI must resolve to a [Collection](/structures/collection) of [User](/entities/users) entities.
-
+
User's likes. URI must resolve to a [Collection](/structures/collection) of [Like](/entities/likes) entities.
-
+
User's dislikes. URI must resolve to a [Collection](/structures/collection) of [Dislike](/entities/dislikes) entities.
-
+
[Notes](/entities/notes) that the user wants to feature (also known as "pin") on their profile. URI must resolve to a [Collection](/structures/collection) of [Note](/entities/notes) entities.
diff --git a/app/types/page.mdx b/app/types/page.mdx
new file mode 100644
index 0000000..bdf4524
--- /dev/null
+++ b/app/types/page.mdx
@@ -0,0 +1,45 @@
+
+## ISO8601
+
+```typescript
+type Year = `${number}${number}${number}${number}`;
+type Month = `${"0" | "1"}${number}`;
+type Day = `${"0" | "1" | "2" | "3"}${number}`;
+
+type DateString = `${Year}-${Month}-${Day}`;
+
+type Hour = `${"0" | "1" | "2"}${number}`;
+type Minute = `${"0" | "1" | "2" | "3" | "4" | "5"}${number}`;
+type Second = `${"0" | "1" | "2" | "3" | "4" | "5"}${number}`;
+
+type TimeString = `${Hour}:${Minute}:${Second}`;
+
+type Offset = `${"Z" | "+" | "-"}${Hour}:${Minute}`;
+
+type ISO8601 = `${DateString}T${TimeString}${Offset}`;
+```
+
+## UUID
+
+```typescript
+type UUID = `${number}-${number}-${number}-${number}-${number}`;
+```
+
+## URI
+
+```typescript
+type URI = string;
+```
+
+## Extensions
+
+```typescript
+type OrgNamespace = string;
+type ExtensionName = string;
+
+type ExtensionsKey = `${OrgNamespace}:${ExtensionName}`;
+
+type Extensions = {
+ [key in ExtensionsKey]: any;
+}
+```
\ No newline at end of file
diff --git a/components/Navigation.tsx b/components/Navigation.tsx
index 1b3cea3..ac78159 100644
--- a/components/Navigation.tsx
+++ b/components/Navigation.tsx
@@ -247,12 +247,8 @@ export const navigation: NavGroup[] = [
title: "Guides",
links: [
{ title: "Introduction", href: "/" },
- /* { title: "Quickstart", href: "/quickstart" }, */
{ title: "SDKs", href: "/sdks" },
- /* { title: "Authentication", href: "/authentication" },
- { title: "Pagination", href: "/pagination" },
- { title: "Errors", href: "/errors" },
- { title: "Webhooks", href: "/webhooks" }, */
+ { title: "Entities", href: "/entities" },
],
},
{