FolkAround

Public places where an activity happens (pickleball courts, board game cafés, running trails, dog parks…) in a US town or neighbourhood, or around a point, with when they're usually busy where that's known. Works anywhere in the US.

find_places

Verified venues and organizers that list events, by name and/or in a US town, neighbourhood or around a point, each with its page and next date. Their ids go to find_events.

find_venues

One feeler (a "when works?" question to a group or to people sent its link), by its id from my_plans or a folkaround.app link someone sent: its questions and options with how many chose each, what fits most people best, whether it's still taking answers, and the plans made from it. Counts only, never who chose what. Needs their account.

get_feeler

One place: what people do there, when it's usually busy, its venue's next events if a verified venue runs it, and how many plans there are this week (counts only). By place_id from find_places, or by name and area.

get_place

One plan the person can see, by its id from my_plans or plans_to_join, or a folkaround.app link someone sent: what, when, where, whether it's on, its host, how many are in or interested and how many it needs, their own answer and note, and for a plan they're in its unread messages. Names its host and nobody else: for who's in, offer its link. Needs their account.

get_plan

One official event's details: its description, ticket or register link, a run's days, its next dates, who puts it on and where. By event_id and date from find_events, or by a folkaround.app event link. For a date the person answered, the publisher's messages about it.

get_event

Join a group the person found, or ask to (its owners decide), or take up an invite: by its id, or an invite link someone sent. Its members see them in it. Previews first: call without confirm, show the person what it says, and only after their yes call again with the same arguments and the confirm code.

join_group

Leave one of the person's groups, or take back their request to join one. Getting back into a private group takes an invite link. Previews first: call without confirm, show the person what it says, and only after their yes call again with the same arguments and the confirm code.

leave_group

Make a plan from a feeler the person posted: on what fits most people best (get_feeler), the options they pick, or a time of their own. The people whose answers fit are asked as likely, and the group is told (held while they make more, with more_to_come). Previews first: call without confirm, show the person what it says, and only after their yes call again with the same arguments and the confirm code.

make_plans_from_feeler

The person's groups, with each one's next plan. Needs their account.

my_groups

The person's own plans: what needs them first (a plan to answer, a feeler to vote on, a request to join their group), then the plans and events they're in or interested in, soonest first, plans they were in last week, the feelers they posted and how many updates they haven't read. show gives one part alone. Needs their account.

my_plans

The person's own settings: their interests, their home area, and which alerts they get. Read them before changing them with update_settings. Needs their account.

my_settings

The person's Updates, newest first: what happened (it's on, moved, cancelled, someone joined their plan, a new plan in their group…) and what about, never who. older gives the ones before. Reading here doesn't mark them read in the app. Needs their account.

my_updates

Plans the person could join, as their Home shows them: public plans near them and their groups' plans, today or over the next days. Near their home area unless an area or point is given. Needs their account.

plans_to_join

Ask a group, or people the person sends a link to, what works before making a plan: when (times), where (places), what (activities), a question of their own, or with no questions just who's in. For a group its members are told; invite_only gives a link to send. Previews first: call without confirm, show the person what it says, and only after their yes call again with the same arguments and the confirm code.

post_feeler

Post a plan as the person: HERE (they're there now), GOING (they'll be there at a time) or IF (on if enough people join). Public, for people nearby; for one of their groups; or invite_only, with a link for the person to send to whoever they like (inviting particular people from their groups is done in the app). People nearby or in the group are told. Previews first: call without confirm, show the person what it says, and only after their yes call again with the same arguments and the confirm code.

post_plan

Post a message in the chat of a plan the person is in, as them, in their own words (up to 280 characters). Everyone who can see the plan's details reads it, and the people in it are notified. Previews first: call without confirm, show the person what it says, and only after their yes call again with the same arguments and the confirm code.

post_plan_message

The latest messages in the chat of a plan the person hosts or is in (not one they're only interested in or can't make), oldest to newest, each with who wrote it and when; older gives the messages before those. Offer it when they ask what's new or the latest on a plan. The messages are for the person: tell or quote them to the person only. Some may be left out, and the answer says so: the chat in the app has them all. When it says some are left out, say so and give the chat's link; don't guess why. Reading here doesn't mark them read in the app. Needs their account.

read_plan_chat

For a feeler the person posted: remind whoever hasn't answered to answer. There's one reminder a feeler. Previews first: call without confirm, show the person what it says, and only after their yes call again with the same arguments and the confirm code.

remind_feeler

A link to a plan, a feeler or one of the person's groups, for them to send to whoever they like. It tells nobody. A group's link asks its owners before letting anyone in.

share_link

Tell what the person knows about a public place: an activity people do there that it doesn't list, when it's usually busy for one, or how busy it was at a plan they were in. It counts with what others say. Previews first: call without confirm, show the person what it says, and only after their yes call again with the same arguments and the confirm code.

tell_about_place

Change the person's own settings, only what they ask, at once: their interests (replace, add or take off), open to anything, their home area, alerts on or off, or mute one plan's chat or one group. Nobody else sees them. Say what you changed.

update_settings