Home User Guide
Complete Documentation

User Guide

Everything you need to create, manage, and grow thriving communities with GoodNests. From getting started to advanced customization.

26 sections ~20 min read All user roles
1

Getting Started

Set up your account and start building your community in minutes.

First-Time Launch

When you open GoodNests for the first time, you'll see a Welcome Screen with the GoodNests cloud illustration and a "Get Started" button. This screen only appears once.

Signing Up (Community Owners)

To create your own community, follow the Owner registration flow:

1Sign Up — Tap "Sign Up" on the login screen and enter your email and password.
2Verify Email — Enter the OTP verification code sent to your email inbox.
3Set Up Your Profile — Add your name, bio, and upload a profile picture (cropped to a square).
4Create Your Community — Enter a community name, description, and optionally upload a logo.
5Customize Your Theme — Choose colors, fonts, and branding for your community.
6Choose a Plan — Select between the Free plan or Pro/Growth plan (with a 7-day trial).
7Invite Members — Add your first members via email, link, or QR code.
8You're Ready! — Tap "Go to Dashboard" to enter your community.

Logging In

1Open the app and enter your email and password.
2If you belong to multiple communities, select which one to enter from the Select Community screen.
3You're taken directly to your community feed.

Forgot Password

1Tap "Forgot Password?" on the login screen.
2Enter your registered email address.
3Follow the instructions sent to your email to reset your password.

2

User Roles & Permissions

GoodNests has four user roles, each with different levels of access.

Permission Owner Admin Mod Member
View feed & interact with posts
React, comment, save posts
Vote in polls
RSVP to events
Use chat/messaging
Create posts
Delete own posts
Delete others' posts
Pin posts
Invite members
Assign roles to members
Customize community theme
Delete community
Full community control

Role Descriptions

  • Owner — The community creator. Has full, unrestricted control over the community including branding, member management, role assignments, and the ability to delete the entire community.
  • Admin — Trusted community managers. Can create posts, invite members, delete posts (except the owner's), customize the theme, and help manage the community.
  • Moderator — Content gatekeepers. Can create posts and delete their own posts to help maintain content quality.
  • Member — Community participants. Can view the feed, react, comment, save posts, vote in polls, RSVP to events, and use chat — but cannot create posts.

3

Creating a Community

During Registration

When you sign up as an Owner, community creation is part of the onboarding flow:

1Community Name (required) — Give your community a name (e.g., "Design Hub", "Book Lovers", "Fitness Tribe").
2Community Description (required) — Describe what your community is about so members know what to expect.
3Community Logo (optional) — Upload an image (PNG, JPG, or SVG). The image will be cropped to a 1:1 square.

After submitting, a unique community slug (URL-friendly name) is automatically generated from your community name.

Creating Additional Communities

1Go to SettingsChange Community.
2In the community switch sheet, tap "Create New Community".
3Follow the same steps: name, description, and logo.

4

Inviting Members

Owners and Admins can invite new members through three methods.

Email Invitations
Enter an email, choose a role (Admin, Moderator, or Member), and optionally add a personal message. Supports bulk invitations.
🔗
Invite Link
A unique invite link is auto-generated for your community. Copy and share it via any messaging app, email, or social media.
QR Code
A QR code is generated for your invite link. Display or share it — anyone who scans it can request to join.

Email Invitation Steps

1Navigate to the Members tab.
2Tap the Invite button.
3Enter the invitee's email address.
4Select a role for the invitee.
5Tap Send — the invitee receives an email with an invitation token.

5

Joining a Community

Accepting an Email Invitation

1Open the invitation email and tap Accept Invitation — this opens a page in your browser.
2Existing user? Enter your password to join the community with the role assigned by the inviter.
3New user? Create a password to set up your account, then accept the invitation — your account is created automatically.

Requesting to Join

1From the Community Choice page, select "Join Existing Community".
2Enter the community slug (or paste the full URL).
3Enter your name and optionally add a message.
4Tap Submit — your request is sent to admins for review.
Duplicate requests are detected automatically — you won't be able to submit a second request while one is already pending.

6

Switching Between Communities

If you belong to multiple communities:

1Go to SettingsChange Community.
2A Community Switch Sheet appears showing all your communities with name, logo, your role, and join date.
3Tap a community to switch — the app reloads with that community's feed, theme, and members.
You can also tap the community logo in the top navigation bar for quick access to the community switcher.


8

The Feed (Home Screen)

The Feed is the heart of your community.

Category Tabs

TabDescription
AllAll posts across all categories
AnnouncementsImportant community-wide updates
EventsPosts with event details and RSVP
TopicsDiscussion threads and conversations

Feed Features

Infinite Scroll
Posts load automatically as you scroll down with cursor-based pagination.
Pull-to-Refresh
Swipe down to refresh the feed with the latest posts.
🔍
Smart Search
Search posts by keyword with smart debounced search (350ms delay).
📶
Offline Caching
Previously loaded posts remain visible even when offline.

Post Display

Each post in the feed shows author info, content with hashtag support, media (images, video, or link preview), poll or event details, reactions, comment count, save button, view count, and timestamp. Pinned posts appear at the top with a pin indicator.


9

Creating Posts

Available to: Owner Admin Moderator roles only. Members cannot create posts.

Tap the + (Create) floating action button to open the post composer.

Post Types

📄
Text Post
Add a title (optional) and content (required). Select a category.
📷
Image Post
Attach multiple images with cropping support. PNG, JPG and more.
🎥
Video Post
Upload videos with auto-generated thumbnails and real-time progress.
📊
Poll Post
Create polls with 2–4 options and optional expiration dates.
📅
Event Post
Create events with date, time, location, and RSVP functionality.
🔗
Link Post
Share external links rendered with an in-app browser.

Post Categories

CategoryUse For
GeneralEveryday posts, updates, and shares
AnnouncementsImportant community-wide announcements
EventsEvent-related content with RSVP
TopicsDiscussion threads and open conversations

10

Interacting with Posts

Reactions

React to any post with one of 5 reaction types: Like, Love, Laugh, Sad, or Angry. Tap a reaction to add it; tap again to remove. Your reaction is highlighted and counts are shown per type.

Comments

Tap the comment icon to open the comment thread. Write a comment and tap send. You can reply to comments to create nested/threaded conversations.

Saving, Sharing & Downloading

  • Save — Tap the bookmark icon to save a post. Saved posts appear in your Profile → Saved tab.
  • Share — Tap the share icon to share a post via your device's native share sheet.
  • Download Media — In the full-screen image viewer, tap download to save images to your gallery.

Viewing Media

  • Image Gallery — Full-screen viewer with swipe navigation and download support.
  • Video Player — Full-screen video with looping and audio mixing.

Pinned Posts

Owners and Admins can pin important posts to the top of the feed. Pinned posts display a pin icon and "Pinned Post" label.


11

Polls

Creating a Poll

1Tap the + Create button and select Poll.
2Enter a poll question and add 2–4 answer options.
3Optionally set an expiration date and time.
4Add a title, any additional content, and tap Post.

Voting & Results

Tap your preferred option to cast your vote (one vote per poll). After voting, you'll see vote percentages, counts per option, your selection highlighted, and the total vote count. Expired polls show an "Expired" indicator with results still visible.


12

Events & RSVP

Creating an Event

1Tap the + Create button and select Event.
2Fill in: Event Title (required), Start Date & Time (required), End Date & Time, Location, and Details (optional).
3Add post content and tap Post.

RSVP Options

StatusMeaning
GoingYou plan to attend
InterestedYou're considering attending
Not GoingYou won't be attending

You can change your RSVP at any time. Each event displays attendee counts broken down by status. Tap to view the full attendee list with profiles.


13

Chat & Messaging

Navigate to the Chats tab to start conversations with any community member.

Real-time Messaging
Messages delivered instantly via live subscriptions.
Typing Indicators
See when someone is typing a response.
🟢
Online Status
Green indicator shows who's currently online.
💬
Unread Badges
Badge count on the Chats tab shows unread messages.

14

Notifications

GoodNests delivers notifications in real-time. You'll be notified about:

TypeTrigger
Post CreatedA new post is published in your community
Comment AddedSomeone comments on your post
Reaction AddedSomeone reacts to your post
Message ReceivedYou receive a new direct message
Conversation CreatedA new chat conversation is started with you

Tap any notification to navigate directly to the relevant content. The notification bell badge shows unread count, and you can scroll through past notifications with infinite scroll.


15

Members

Navigate to the Members tab to see all community members.

Filtering Members

FilterDescription
All MembersEveryone in the community
StaffOwners, Admins, and Moderators only
Most RecentNewest members first
OldestLongest-standing members first

Use the search bar to find specific members by name. Each member card displays their profile picture, name, role badge, and a Follow/Unfollow button.


16

Profile Management

Your profile shows your picture, name, bio, website, and follower/following counts. It has two sub-tabs: Posts (your published content) and Saved (bookmarked posts).

Editing Your Profile

1Go to Profile tab → tap Edit Profile.
2Update your Name, Bio, Link, or Profile Picture.
3Tap Save to apply changes.

Email & Password

Go to SettingsEmail & Password to update your email address or change your password.


17

Follow System

  • Follow — Tap the Follow button on any member's profile or in the members list to stay connected.
  • Unfollow — Tap Unfollow on a user you're currently following.
  • Counts — Your follower and following counts are displayed on your profile. Tap to view the full list.
  • Mutual Follows — The app tracks whether a user follows you back.

18

Community Customization & Theming

Available to: Owner and Admin roles only.

Color Schemes

Choose from 3 preset themes or create a custom palette:

PresetPrimaryAccentBackground
Forest Green #2D4A3E #7A9E8E#E8F0EC
Warm Gold #C4993D #E8D5A8#FFFDF9
Ocean Blue #5094D4 #779FE5#E0E8FF
CustomYour choiceYour choiceAuto-generated

Font Selection

FontStyle
Inter (Default)Clean, modern sans-serif
PoppinsGeometric sans-serif
NunitoRounded sans-serif
RobotoGoogle's signature font
MerriweatherElegant serif font

Managing Themes

  • Save a theme for later use.
  • Create multiple themes and switch between them.
  • Set an active theme — applied community-wide for all members.
  • Update existing themes (name, colors, font).
  • Delete themes you no longer need.
  • Load defaults to reset to the original theme.
  • All changes are previewed in real-time before saving.

19

Community Statistics

The community dashboard provides detailed analytics:

👥
Member Metrics
Total members, new today, online now, and active this week.
📈
Post Metrics
Total posts, new today, this week, and this month.
💬
Engagement
Total comments, reactions, and avg posts per member.
🚀
Growth
Member growth rate, post growth rate, and role distribution.

20

Privacy & Safety Settings

Control your privacy and notification preferences from Settings:

SettingDescriptionDefault
Push NotificationsEnable/disable push notification alertsOn
Mentions & RepliesGet notified when mentioned or replied toOn
Show Online StatusAllow others to see when you're onlineOn
Allow Direct MessagesControl whether others can DM youOn

21

Offline Support

GoodNests is designed to work even when your internet connection is unreliable.

📤
Offline Post Queue
Posts created while offline are saved locally and auto-submitted when connection is restored. Retries every 5 minutes.
🎨
Offline Media Queue
Failed media uploads are queued and resume automatically when connectivity returns.
💾
Cached Content
Previously loaded posts remain visible and browsable even when offline.
📡
Connectivity Monitor
Real-time network status monitoring with a loading indicator during reconnection.

22

App Guide & Walkthrough

When you first enter the app, an interactive guided tour highlights key features: Feed Tab, Members Tab, Create Post Button, Chats Tab, Profile Tab, Notification Bell, and Community Logo.

A separate guide appears the first time you visit Settings, highlighting Community Customization, Notification Preferences, and Privacy & Safety settings.

To replay the walkthrough, go to SettingsShow App Guide.

23

Plans & Pricing

GoodNests offers three product tiers to fit your needs:

💼
GoodNests Business
For businesses, creators, and media companies. Monetize your community with ads, premium content, and paid memberships.
💚
GoodNests Community
For nonprofits, churches, and mission-driven organizations. Ad-free with donation links and engagement tools.
GoodNests Gold
Fully private, completely custom-branded. White-glove onboarding and bespoke features for premium communities.
1
2
3

Which product interests you?

Pick the one that best fits your needs.

Tell us about yourself

We'll use this to tailor our outreach to you.

Please enter your name.
Please enter a valid email.
Please enter your organization name.
Please select an option.
Please select a range.

Anything else you'd like us to know?

Tell us about your goals or questions. (Optional)

We'll be in touch!

Thanks for reaching out. Our team will review your details and get back to you within 24 hours with a personalized plan.


24

Account Management

Logging Out

Go to SettingsLogout. Confirm in the dialog, and all local data and tokens are cleared.

Deleting Your Account

This action is permanent and cannot be undone. All your data, posts, and community memberships will be deleted.
1Go to SettingsDelete Account.
2Enter your password to verify your identity.
3Tap Delete to permanently remove your account.

Deleting a Community

Available to Owners and Admins only. This action is permanent. All community data — members, posts, media — is permanently deleted.
1Go to SettingsDelete Community.
2Type the community name exactly to confirm.
3Tap Delete to permanently remove the community.

25

Web Support

GoodNests works on the web with a responsive design.

Screen WidthLayout
< 900pxMobile-like layout (same as phone)
> 900pxDesktop layout with sidebar navigation and wider content area
  • All mobile features are available on web.
  • File uploads work via browser file picker.
  • Desktop navigation uses a rounded navigation bar with pill-style active indicators.
  • Browser back/forward buttons work for navigation.
  • Content width is constrained for comfortable reading on large screens.

26

Frequently Asked Questions

No. Only Owners, Admins, and Moderators can create posts. Members can view, react, comment, save posts, vote in polls, RSVP to events, and use chat.
Only the community Owner can change member roles. Contact your community Owner to request a role change.
Yes! You can join or create multiple communities and switch between them from Settings → Change Community.
Your post is saved locally and will be automatically submitted when your connection is restored. The app retries every 5 minutes.
Yes, if you're an Owner or Admin. Go to Settings → Community Customization to change colors, fonts, and logo.
Owners and Admins can pin posts. Pinned posts appear at the top of the feed with a pin icon.
Yes. Open an image in the full-screen viewer and tap the download button to save it to your device gallery.
Go to Settings → Show App Guide to replay the interactive walkthrough.
Yes. Authentication tokens are stored in secure encrypted storage, and all API communication uses HTTPS.
Go to Settings → Contact Support to reach the GoodNests support team.