# DS Chat — User Guide A quick reference for everyday use: sending messages, organizing rooms, attachments, notifications, and personalizing your account. ## Contents - [Getting started](#getting-started) - [Rooms](#rooms) - [Sending messages](#sending-messages) - [Formatting](#formatting) - [Mentions and room links](#mentions-and-room-links) - [Attachments](#attachments) - [Reactions](#reactions) - [Editing a message](#editing-a-message) - [Presence and notifications](#presence-and-notifications) - [Your profile](#your-profile) - [Room details](#room-details) - [Staying up to date](#staying-up-to-date) ## Getting started DS Chat is invite-only — there's no public sign-up page. You'll either be given an account directly, or you'll receive an email invite with a link. Opening that link lets you pick a username and password; once you submit it, you're signed in automatically. If you forget your password, use **Forgot password?** on the login screen. You'll get an email with a reset link that's valid for 15 minutes. ## Rooms Rooms are where conversations happen — similar to channels in other chat apps. The sidebar on the left lists every room you belong to, with a search box at the top to filter by name. - **Create a room**: click the **+** button above the room list. Give it a name and, optionally, a description. You become that room's owner. - **Browse rooms**: click **Browse rooms** to see every *open* room on the site and join any of them directly. - **Private rooms**: a room marked private (shown with a lock icon) isn't listed in Browse rooms — you can only get in by being added by an owner or admin of that room. - **Unread indicators**: a room with new activity shows a dot next to its name — a plain dot for unread messages, a highlighted dot if you were specifically @mentioned. ## Sending messages Type in the message box at the bottom of a room and press **Enter** to send. Use **Shift+Enter** to add a line break without sending. ## Formatting Messages support Markdown: - `**bold**`, `*italic*`, `~~strikethrough~~` - `` `inline code` `` and fenced code blocks (three backticks) - `> blockquotes` - `-` or `1.` for bulleted/numbered lists - `[link text](https://example.com)` — or just paste a bare URL and it becomes clickable automatically - `#`, `##`, `###` for headings Pasting a link on its own often also generates a preview card underneath your message, pulled from that page's title/description/image, when the page provides one. Emoji: click the 🙂 button in the composer to open the emoji picker, or type a shortcode like `:tada:` and it's converted automatically once you send. The picker remembers your recently-used emoji and has a search box. ## Mentions and room links Type `@` followed by a few letters of someone's username to open an autocomplete of that room's members — pick one (or press Enter/Tab) to insert a mention. Mentioning someone highlights the message for them and marks the room specially in their sidebar, even if they're not currently looking at it. Type `#` followed by a few letters of a room name to do the same for rooms you belong to — it inserts a clickable link that takes anyone who can see the message (and is a member of that room) straight to it. ## Attachments Click the paperclip icon to attach a file, or just drag a file onto the message box and drop it. Images show as an inline thumbnail — click one to view it full-size. Other files show as a small card with the filename and size; `.txt`, `.md`, and `.pdf` files open in a preview without leaving the room, everything else downloads when clicked. There's a server-configured maximum file size — if a file is too large, you'll see an error before it uploads. ## Reactions Hover over a message and click the 🙂 icon in its action row to react with an emoji. Reactions from everyone appear as small pills under the message with a count; click an existing pill to add or remove your own reaction to it. Hovering a pill shows who reacted. ## Editing a message You can edit any message you sent: hover it and click **Edit**, make your changes, then press **Enter** to save or **Escape** to cancel. Clicking away also saves. Edited messages are marked *(edited)*. ## Presence and notifications Everyone's avatar shows a small status dot — green for online, grey for offline — based on whether they currently have the app open. If you'd rather not broadcast that you're active, open your account menu (click your avatar, top right) and choose **Appear offline**. The same menu has a notifications toggle: - In a regular browser, turning it on asks your browser for permission and subscribes you to push notifications for messages in rooms you're not actively looking at. - In DS Chat Desktop, the same toggle controls native desktop notifications instead — no browser permission prompt needed. You'll get a notification whenever the app is minimized *or* simply not the focused window, even if it's still open somewhere on screen. ## Your profile Open your account menu and choose **Profile settings** to: - Upload or remove a profile photo - Set a display name (shown instead of your username throughout the app) - Pick a theme — Dark, Light, Midnight, Sunset, or build your own custom color scheme (create one, then customize each color; changes preview live) - Change your password ## Room details Click the info icon in a room's header to open its details panel, where you can: - See who else is in the room and their role (member/admin/owner) - Browse and re-download every file and image ever shared in the room, without scrolling back through history - Leave the room — unless you're the owner, in which case ownership has to be transferred to someone else first Room admins and owners see additional management options here that aren't covered in this guide. ## Staying up to date If your connection drops, a banner lets you know you're offline and working from cached data — sending is disabled until you're back online. When a new version of DS Chat has been deployed, a banner offers a **Reload** button to pick it up immediately, instead of waiting for your next natural page refresh.