​

Set Up Your Organization

The first step toward launching your Oasis app is to log into the admin dashboard, choose or create your organization and lay the groundwork for your app’s structure. The dashboard runs in your browser; no software installation is required.

​

1. Access the Admin Dashboard

1. Open your browser and navigate to the admin URL provided by the Oasis team (for example https://dashboard.getoasis.org or a custom subdomain). If you’re unsure of the address, check your onboarding email or ask the Oasis support team.
2. Sign in using the credentials provided for your administrator account. Usually this is an email address and a password or one‑time code. If this is your first time signing in, you may be prompted to create a password or verify your email.
3. If your account has access to multiple organizations, an Organization Selector will appear. Choose the org you wish to configure. Most admins will only see one.

[!gotcha] If you see a red banner warning that your subscription has been cancelled or the app is disabled, contact the Oasis team immediately to restore access before proceeding.

​

2. Configure Basic Details

After selecting your organization you’ll land on the dashboard. Before adding pages, ensure your org’s basic information is correct:

• Organization Name – This is the name displayed to users in notifications and on some screens. If it’s incorrect, update it here. Some deployments require contacting support to change the name.
• Contact Email – Optional; the email shown if users need help. Enter a generic address (e.g. info@yourchurch.org) if you want messages to go to a shared inbox.

It’s also a good time to think about your primary audience (church members, youth, volunteers, etc.) and what information they need from the app. Jot down the types of content you plan to deliver: announcements, event schedules, sermon recordings, donation links, and so forth. This will inform your page structure.

​

3. Plan Your App Structure

Oasis apps consist of multiple pages. Pages can be shown in the tab bar (visible at the bottom of the mobile app) or hidden and only accessible via links or notifications. Decide what pages you need and how many tabs you want in your app. A typical church app might have: Avoid creating too many top‑level tabs; 3–5 main pages is usually ideal. If you have more content, group it within custom pages using links or expandables.

​

4. Create Pages

To add a new page:

1. In the sidebar, click Pages (sometimes labeled “App” or “Layout”).
2. Click Add Page or Create Page. If you want the page to appear in the tab bar immediately, you can use the Add Tab workflow if available.
3. Choose a page type based on the content:
   • Custom (Blocks) for free‑form text, images and buttons.
   • Calendar to display events from iCal feeds.
   • Announcements to list posts from an RSS feed.
   • Audio to stream podcast episodes via an RSS feed.
   • Webview to embed an external webpage, form or tool.
   • Built‑in pages like Notifications, Notification Groups or Settings.
4. Enter a title (one or two words) for the page. This name appears in the tab bar and as the header in the app. You may also set a subtitle or choose an icon depending on the type.
5. Configure any type‑specific settings (for example, paste your RSS feed URL for an Announcements page, or select which calendars to show for a Calendar page). For custom pages, you’ll add content blocks after creating the page.
6. Save the page.

After creating a page, add it to your tab bar (if it isn’t there already): go to the App Layout or Tabs section and select the page you just made. Reorder the tabs so that the most important one appears first. Users typically see the first tab when they open the app.

​

5. Populate Custom Pages

For Custom (Blocks) pages, click Edit next to the page and add content using blocks:

• Text/Markdown Blocks – Insert headings, paragraphs, lists and simple formatting.
• Image Blocks – Upload banners or photos. Images are resized to fit the device width.
• Button Blocks – Create buttons that link to other pages or external sites. Perfect for calls‑to‑action like “Join a Small Group” or “Donate Now”.
• Page Link Blocks – Link to other pages within your app. Use these to build nested navigation menus.
• Emoji Blocks and Header Blocks – Add visual interest and separate sections.

Drag and drop blocks to reorder them. Save your changes to publish the page. There is no draft mode—edits become live immediately—so avoid updating during peak usage or remove the tab temporarily while making substantial changes.

​

6. Set Up External Feeds

If you’re using Calendar, Announcements or Audio pages, you’ll need to add feed URLs.

1. For a Calendar page, go to Calendars in the sidebar and add each iCal URL you want to display. Give each feed a name (e.g. “Sunday Services” or “Youth Events”). Return to your Calendar page and select the calendars you added.
2. For an Announcements page, paste the RSS feed URL of your news or blog. Make sure it returns valid XML. You can usually find RSS URLs on the blog’s website or by contacting whoever manages your site.
3. For an Audio page, provide the RSS feed URL of your podcast. The feed must include <enclosure> tags with MP3 or M4A files. When configured, the app will automatically list and play episodes.

Always test feeds on a mobile device after adding them. If the feed fails to load or looks incorrect, double‑check the URL and format on a desktop browser.

​

7. Decide on Events

If you plan to host conferences, retreats or other time‑bound gatherings, you can create events within your app. Events provide schedules, attendee lists and targeted notifications. Creating an event is optional—you can run a full app without any events. To learn more about events, including how to create them, manage schedules and invite attendees, see the Events guide.

​

8. Preview and Test

Before launching to your community:

• Install the Oasis mobile app (or your branded app) on a test device. Sign in if necessary and verify that your pages load correctly, images look good and feeds populate as expected.
• Check navigation: ensure the tab order makes sense and the icons match the content.
• If you added an event, try logging in as an attendee (you may need to add yourself to the attendee list) and review the event schedule.
• Send yourself a test notification if you plan to use push messages.

Iterate on your setup until you’re satisfied. You can always come back to the dashboard to add or remove pages, update content or create more events as your organization grows.