/landscape-apps

Start, host, and cultivate communities.

Primary LanguageTypeScriptMIT LicenseMIT

Landscape apps

Groups

Start, host, and cultivate communities. Own your communications, organize your resources, and share documents. Groups is a decentralized platform that integrates with Talk, Notebook, and Gallery for a full, communal suite of tools.

Talk

Send encrypted direct messages to one or many friends. Talk is a simple chat tool for catching up, getting work done, and everything in between.

Notebook

Notebook is a standard short and long form text editor. Within Groups, you can use Notebook to write, edit, and publish text.

Gallery

Gallery is a versatile repository for collective knowledge and references you want to share or remember. Within Groups, you can use Gallery to collect links, images, media, and even random musings.

Learn more about Landscape, Tlon, and Urbit


Slated for launch

Groups and Talk are under active development with a full 1.0 release date in sight. Notebook and Gallery will be released as channels in Groups, with full standalone apps coming later (see list below).

We are currently working on:

  • A clean, error-free migration of Groups 1 data
  • Secret, invite-only groups
  • Mobile-responsive layout and interaction fixes
  • @mentions

Coming later

  • Arrangeable ordering in Notebooks and Gallery
  • Blocking users in Talk
  • Rich embeds of web2 content
  • Content search within channels
  • Standalone Notebook, Gallery, and Contacts apps in Landscape
  • Remote storage updates
  • Group discovery and user onboarding updates

Developer documentation

This project uses the formal comment spec for all Hoon code to ensure compatibility with doccords once support is released.

Additionally, detailed documentation is available in the Docs Landscape app if you have both Docs and Groups installed on a running Urbit ship.

Visit the Tlon Public group on-network (~nibset-napwyn/tlon) for instructions on how to install the public beta versions of Groups and Talk.

Integrating with Groups agents

The %groups desk provides several simple agents with discrete concerns. This list may expand over time, but new agents are unlikely for the time being.

  • %groups - The organizational substrate for constructing, joining, finding, and managing groups (different than the in-group activity of chatting, writing, or collecting)
  • %chat - 1:1 and multi-DM capabilities for Talk and Chat channels in Groups
  • %diary - Notebook channels in Groups
  • %heap - Gallery channels in Groups
  • %hark - Notifications within Groups and Talk, and a general notification bus for Landscape, which will eventually be moved to Landscape proper
  • %notify - Hooks for iOS push notifications

All actions are performed with pokes. See the on-ship developer documentation for more details.

Use of current-day Landscape agents

At the moment, Groups and Talk both make use of %settings-store, %s3-store, and %contact-store agents in the %landscape desk. We will eventually distribute these as part of the base %garden desk (and finally rename %garden to %landscape, reducing confusion everywhere).

We have plans to replace %contact-storewith a Groups agent (and standalone contact + identity management app) on the tails of Tlon core devs’ subscription reform efforts. Nothing is changing in the short-term, but if your app uses this store, you may want to stay subscribed to our announcements in the urbit-dev mailing list.