Documentation

Agenda Capoeiragem tutorials

Step-by-step guides for students, travelers, and educators. Learn every feature using the exact text you will see in the app.

General

Getting started

How to create your account, complete your profile, and join your community.

1

Install the app or use it as a web app

Download it from Google Play on Android, or open agendacapoeiragem.com in your browser and add it to your home screen as a web app (PWA). Both options work the same way.

Note — The native iPhone version is in development. In the meantime, use Safari on iOS → "Add to Home Screen".
2

Create your account

Fill in your first name, last name, optional nickname, country (auto-detected), your role (Practitioner or Educator — just another field on the same form), email, and password.

Tip — Choose "Educator" if you already teach capoeira — this unlocks the management tools from the start. You can change it later.
Note — To sign up with Google instead of filling in the form, do it from the login screen (not available on web).
3

Complete the onboarding

After registration, a wizard guides you step by step. If you are a student: complete your profile, find your group, and pick your school. If you are an educator: complete your profile, choose whether to join an existing group or create your own, and finish by creating your school.

Note — The profile step requires selecting a gender before you can continue.
4

Link your group

If you finished onboarding without joining a group, you will see the "You don't belong to a group yet" card on Home with "Find group" and "Guided request" buttons (and "Create group" if you are an educator).

Warning — Without a linked group you cannot see your community's events or graduation history. Attendance and payment features will also be unavailable.

General

Home & discovery

How to navigate the main screen and find what you need quickly.

1

The Home screen

The "Home" tab shows a personalized greeting with your name and the "Upcoming events" section with your community's events in chronological order. A red badge on the "Profile" tab indicates pending notifications.

Tip — Pull down to refresh the feed at any time.
2

Filter upcoming events

In the "Upcoming events" section you will find filter chips: "All", "Today", "This week", and "This month". Tap them to narrow the view.

3

Global search

Tap the search bar on the Home screen to open global search. Type any term and you will see results organized in four sections: Events, Groups, Schools, and Users.

4

Home cards and reminders

Above "Upcoming events" you may see contextual cards: a request of yours pending approval, your next class (if you train at a school) with your attendance streak, or — if you are an educator — a quick shortcut to record today's attendance.

5

Educator quick actions

If you manage a single school, you'll see two fixed chips below the filters: "School panel" and "Record class", to jump straight into those screens.

General

Groups & community

How to discover groups, join one, and explore your community's hierarchy.

1

What is a group and what is a school (núcleo)?

A **group** is the capoeira organization as a whole (e.g. Abadá Capoeira, Cordão de Ouro). A **school** (núcleo) is a specific physical training location within that group — one group can have many schools in different cities or countries. You belong to a group and train at a school. Educators create schools inside their group.

Note — When the app says "your school" it means the specific place where you train. When it says "your group" it means the whole organization.
2

Browse groups

The "Groups" tab shows all public groups on the platform. Use the search bar ("Search group...") to filter by name, and the "Country of presence" and "Capoeira style" dropdowns to narrow the search.

3

A group's profile

Tap any group to see its profile. It's a single scrolling screen: description, a collapsible "Graduation system" section, a "Hierarchy" card (opens the educator tree on a separate screen), and the group's upcoming events.

4

Request to join a group

The "Request to join the group" button appears on the profile only if you are an educator (or hold educator-level graduation) without a group yet. Your request will show the badge "Request pending approval".

Tip — If you are a student without a group, use "Guided request" instead: it walks you step by step through picking your school (and its educator) before sending the request.
5

View the group hierarchy

Tap the "Hierarchy" card on the group profile to open the full educator tree, with search by name. Tap any educator to see their public profile.

6

View a member's profile

Tap the name of any educator or member to see their profile: name, nickname, group, current belt, and schools where they teach or train. The graduation history is also publicly visible.

General

Events

How to discover, filter, and confirm your interest in batizados, rodas, and more.

1

Explore the events calendar

The "Events" tab shows an interactive calendar at the top and the event list below. Tap any date to see that day's events. You can toggle between calendar view and list view with the button in the corner.

2

Filter by category and more

Next to the view toggle there are 3 quick chips: "Free", "Online", and "This weekend". For more options, tap "Filters": category (batizado, roda, open roda, troca de corda, course, workshop, seminar, festival, meetup, intensive, training, or a custom category), price, format, dates, group, and location.

Tip — You can combine multiple filters at once.
3

Event detail

Tap any event to see the full description, date and time, map location, organizers, and poster if it has one. You will also see how many people are going ("Going") and how many marked interest ("Interested"), with a strip of avatars of who's going.

4

Confirm "Going" or "Interested"

From the event detail, tap "Interested" to save it to your list, or "Going" to confirm attendance. Tapping the same button again removes your confirmation.

Tip — Events you marked as "Going" appear highlighted on your Home screen.
5

Share an event

Use the share button in the event detail to send it via WhatsApp, Instagram, or other apps. The event name, date, and a direct link are shared.

General

Your profile

How to manage your identity, notifications, and access settings.

1

How your profile is organized

The "Profile" tab is a single screen (no internal tabs): your photo, role, and group at the top; then an "Activity" button; and further down the sections for your role — "Management" (educators, their schools) or "Where I train" (students, attendance and payments).

2

Edit your profile

Tap the edit icon (pencil) on your profile photo or name. You can change your photo, first name, last name, nickname, a short bio, country, date of birth, gender (required), and your social links (Instagram, Facebook, WhatsApp, YouTube, TikTok, and website). Save by tapping "Save".

Tip — A square image looks best in the circular profile picture.
3

Your belt

Your current belt appears with its color and name below your name in the profile. Tapping it takes you to your group's full graduation system (all levels), not a personal history of your own promotions.

4

Settings: language and theme

From "Profile", tap "Settings". There you can change the language (Spanish, Portuguese, English, French, German, Italian) and the visual theme (light or dark). Changes apply immediately.

5

Push notifications: choose what you want to receive

In "Settings → Notifications" turn each type on or off separately: event reminders, new events from your group, events near you, weekly digest, and community news.

Tip — If you enable GPS location, the app detects your current country to notify you of relevant events even while traveling.
6

Activity: requests and upcoming events

Tap the "Activity" button on your profile to see your confirmed upcoming events and your pending requests: group, school, educator, school transfer, and event collaboration. The red badge on the "Profile" tab shows how many you have unread.

7

Report a problem

Go to "Profile" → "Settings" → "Report a problem". Your report goes directly to the development team.

General

Premium plan

What the free plan includes, what Premium unlocks, and how to subscribe.

1

Free plan limits

With a free account, educators can create up to 10 events per month and students can confirm attendance at 1 roda per month. School management, attendance, and payment features are available without limit for both roles.

Note — Students on the free plan see ads inside the app.
2

What Premium includes

Premium unlocks unlimited events for educators, up to 5 rodas per month for students, priority support, and an ad-free experience.

Tip — The annual plan is marked with the "BEST VALUE" badge and is significantly cheaper than paying month to month.
3

How to subscribe

Go to "Profile" → "Subscription" or tap the Premium banner that appears when you reach a limit. Choose the monthly or annual plan and confirm the payment with your Google Play or App Store account.

Note — Payments are processed securely through Google Play / App Store. Agenda Capoeiragem does not store card data.
4

Restore purchases

If you change devices or reinstall the app, go to "Profile" → "Subscription" → "Restore purchases" to recover your active plan without paying again.

Tip — Use the same Google or Apple account you used to purchase the plan.

Practitioners

Joining a school

How to find a school, send a request, and what happens next.

1

Find your school

Go to the "Groups" tab, search for your group by name (or filter by country/style), and open its profile. From there you can reach the school where you train.

2

Join the school

On the school profile, tap "Join". Your request stays pending until the educator approves it.

Tip — If you don't have a group yet, use "Guided request" from the group profile: it walks you step by step through picking your school before sending the request.
3

Wait for approval

Your request stays as "Pending" until the educator approves or rejects it. You will receive a notification when there is a response.

Warning — Only the responsible educator (or a co-educator) can approve requests.
4

Access your activity

Once approved, the school appears in your profile, in the "Where I train" section — with your payment status and access to your training stats.

Practitioners

Your personal history

How to view your attendance, your training streak, and your payment status.

1

Where I train

In your profile, the "Where I train" section lists every school you belong to with a payment status badge (Paid, Pending, Overdue, Free...) and, if you have a pending payment, a "Report payment" button.

Note — Your payment status is visible only to you and your educator.
2

My activity

Tap "View stats" on any of your schools to open "My activity": your streak of consecutive classes, how many classes you've done this month / in the last 30 days / this year, a frequency chart, your recent sessions, and your payment history. You can share your stats with the dedicated button.

3

Your belt

Your current belt appears on your profile. Tapping it takes you to your group's full graduation system — there is no separate personal history of your own promotions, but your current belt is always visible there.

4

Confirmed events

Tap "Activity" on your profile to see upcoming events you confirmed "Going" to.

Educators

Creating your group

How to register your capoeira group on the platform and configure its information.

1

Access the creation form

If you are an educator without a group yet, you'll see a "Create group" banner on Home or "Create new group" on the "Groups" tab. Tap it to open the form.

Note — Only users with the Educator role can create groups.
2

Name and description

Enter your group's official name and a description. Both are required. The name will appear in the directory, on member profiles, and on your events.

3

Capoeira style (required)

In the "Capoeira style *" field, type the style you practice (e.g. Mixed, Benguela, Angola, Regional). It is free text and required — it's used as the name of your graduation system.

Tip — The "City" field is optional.
4

Group logo (optional)

Upload your logo from your gallery. It will appear on the group profile, in its schools, and on the card your students see on Home.

5

Create the group

Tap "Create". If the name is not a duplicate, the group is created immediately and you go straight into its profile.

6

Invite members

There is no invite code. Share your group's name with your students: they search for it in the "Groups" tab and request to join. You can also add them directly from your school admin panel.

Educators

Managing your group

How to manage requests, admin roles, and group information.

1

Approve or reject group join requests

Group join requests are answered from "Activity" on your profile, along with your other notifications. Tap the request to approve or reject it.

Note — You only see these requests if you manage the group.
2

Assign roles: admin and co-admin

From the group profile, open the administration panel (visible only to admins and co-admins). There you can grant or remove the "Admin" or "Co-admin" role for any member, or remove your own with "Leave admin".

Note — These changes are reversible.
3

Edit group information

Go to the group profile → edit icon. You can change the logo, name, description, and capoeira style. Changes are reflected immediately in the public directory.

Educators

Educational supervision

How to assign a supervising educator for your school's students.

1

What educational supervision is

Educational supervision is the hierarchical relationship between educators in the same group. A more experienced educator can oversee the progress of another educator's students, especially useful across different cities or countries.

2

Automatic supervision (same school)

If the supervisor and students share the same school, supervision is automatic — you'll see the "Same school" badge on the student's profile.

3

Manual supervision (outside the school)

If you don't have your own school, choose supervisors manually: on the supervision screen, tap directly on the educator in the "Suggested supervisors" list, then "Save changes". Students supervised this way show the "Outside your school" badge.

Tip — Only educators from the same group can be assigned as supervisors.
4

View the supervision tree

On the group profile, tap the "Hierarchy" card to open the full educator tree and who supervises whom.

Educators

Creating your school

How to create your school, place it on the map, and set up training schedules.

1

Access the creation form

Go to "Profile" → "Management" section → "Create school" button. If you are creating your first group, this step also appears inside the initial setup wizard.

Note — You need to be an educator in a group to create a school. If you just created your group, you already have that role.
2

Fill in the name and location

Complete "School name" (e.g. Downtown School), "Location" (full address), "Country", and "City". All are required.

Tip — After entering the address, tap the map to drag the marker to the exact spot.
3

Add training schedules

In "Training schedules", tap "Add schedule": weekday, start time, and end time. At least one schedule is required.

Warning — Class groups (students grouped by time slot) can only be set up at this point — there is no way to add them later. If you train different levels at different times, define it now.
4

Create the school

Tap "Create school". If all fields are complete, the school is created and visible in the directory.

5

Edit or delete the school

To edit the name, address, or schedules, go to the school profile → edit icon. "Delete school" is permanent and only available to the responsible educator — there is no option to just hide it from the directory.

Warning — Deleting a school is irreversible.
6

Set up the billing system

Inside "Edit school" you'll find the billing section. Turn on "Free classes" if you don't charge a monthly fee. If you do, enter the monthly price, currency, and the day of the month payment is due.

Tip — If you have students with different rates by time slot, each class group can have its own price.

Educators

Co-educators

How to add co-educators to your school and manage their permissions.

1

What a co-educator is

A co-educator is an educator from the same group who helps manage your school: they record classes, mark attendance, register payments, and can edit the school's settings. Only deleting the school or transferring responsibility are reserved for the responsible educator.

2

Add a co-educator

Go to your school's admin panel → "Team" tab (visible only to the responsible educator). Pick from the list of the group's educators and confirm.

3

Remove a co-educator

In the "Team" tab, tap the co-educator's name and choose "Remove co-educator".

Warning — Removing a co-educator does not delete any data: everything they recorded remains in the system.
4

Leave the co-educator role

If you are a co-educator at a school and no longer want to be, go to the school's public profile and tap "Leave role".

5

Transfer school responsibility

From the "Team" tab, the responsible educator can transfer responsibility to an active co-educator. Whoever transfers becomes a co-educator of the school.

Educators

School join requests

How to manage join requests to your school from the admin panel.

1

View pending requests

Go to your school's admin panel → "Requests" tab. You will see all pending join requests, with the applicant's name, photo, and date.

2

Approve or reject a request

On each card, tap the ✓ icon to approve or the ✕ icon to reject. The applicant gets a notification with the response, and if approved, they immediately appear in your student list.

Tip — If you reject someone by mistake, they can send a new request.

Educators

Students & class groups

How to view your students and add members without an app account.

1

The school admin panel

Access it from "Profile" → "Management" section → your school, or from the school profile by tapping the admin button. You will find "Attendance" (opens by default), "Students", "Payments", and "Reports".

2

View the student list

In the "Students" tab you will see all members linked to your school with their name, current belt, and monthly attendance percentage.

3

Add a student without an account (ghost member)

In the "Students" tab, tap the "+" icon to manually register a student who doesn't use the app. Enter their name and basic details.

Note — Students without an account can receive graduations and have attendance and payment records just like any other student. Once they sign up in the app, you can link their profile to preserve the full history.
4

Class groups

Class groups (students organized by schedule) are defined once, when creating the school — there is no screen to add new ones afterward.

Tip — Having class groups makes attendance faster: the attendance screen only shows the students for the selected time slot.
5

View an individual student's profile

Tap any student's name to see their record: belt, monthly attendance percentage, attendance history, and payment record.

Educators

Attendance tracking

How to record a class, mark present and absent, and review history.

1

Record a class

In the school admin panel → "Attendance" tab, tap "Record today's class". You can change the date in the form to record a class for a different day — the app adjusts the available schedules based on the chosen date.

2

Select schedule and class group

In the session form, select the matching schedule. The app automatically loads the students for that group.

Tip — If you have no class groups configured, the list will show all students in the school.
3

Mark present and absent

Tap each student's name to toggle between present and absent.

4

Suspend a class

If the class didn't happen (holiday, rain, etc.), turn on "Suspend class" before saving. It's recorded with a "Suspended" badge and doesn't count toward attendance or billing.

5

Save the class

Tap "Save class". The app shows a dialog with the present and absent counts — tap "Confirm" to record the session.

6

Review previous sessions

In the "Attendance" tab, sessions appear in chronological order. Tap any past session to see the detail or edit it.

Educators

Payments & treasury

How to record monthly fees, track who owes, and export reports.

1

The "Payments" tab

In the school admin panel, go to the "Payments" tab. Each student appears with their current month's status: Pending, Paid, Paid (late), Overdue, Free, Reported (the student flagged they paid), or Duplicate.

Warning — The "Payments" tab only appears if the school has "Free classes" turned off.
2

Record a student payment

Tap the student's name in the "Payments" tab and then "Record payment". Enter the amount, the corresponding month, and, if applicable, a discount (fixed amount or percentage) — handy for scholarships.

Tip — You can record advance payments: just select the corresponding future month.
3

Review a payment reported by a student

When a student reports their payment from their own profile, it shows up in your "Payments" tab tagged "Reported". Tap it and edit it like any other payment to change its status to "Paid".

4

See who has pending or overdue payments

In the "Payments" tab list you can see all students' statuses at a glance, including the configured payment due day.

5

Generate and export the monthly report

Go to the "Reports" tab of the school panel. Select the format (CSV or PDF) and tap "Generate report". It includes the month's payment and attendance summary.

Educators

Graduation system

How to set up your group's belts and record level changes.

1

Access the graduation system

Go to your group's profile → collapsible "Graduation system" section → "Manage full system" (or "Set up system now" if you don't have levels yet).

2

Create a belt level

Tap "Add level". Enter the belt name, select the colors that compose it, and indicate whether it has painted tips and how many.

3

Organize by category

Levels are organized into sections: adult, youth, children's, trainee instructors, and special levels. Assign the correct category when creating or editing each level.

4

Define the educator level

You can mark from which belt a student is considered an "educator" in the group — this determines who has access to create schools and use management tools.

5

Assign a graduation

From the graduation system screen, tap "Assign graduation to members". Find the student, select the new level and date. The change shows on their profile immediately.

6

View a student's belt

Tap any group member's name to see their current belt with its color.

Educators

Create & manage events

How to publish a batizado, roda, or workshop for the community to see.

1

Create an event

Go to the "Events" tab and tap the floating "+" button.

2

Fill in the basic details

Enter the event name, description, and category (batizado, roda, open roda, troca de corda, course, workshop, seminar, festival, meetup, intensive, training, or a custom category).

3

Date, poster, and documents

Set a start and end date (with a recurrence option), upload a cover image (poster), and, if you need to share rules or regulations, attach a PDF up to 10MB.

Tip — Events with a poster get higher visibility in members' feeds.
4

Price and schedule

If the event has a cost, enter the price and accepted payment methods (bank transfer, cash, Mercado Pago, PayPal, or other). If the event has several activities, add them under "Agenda" — each block with its own time, description, and location.

Tip — When you add an agenda block with a location, the event's general location is derived automatically from those blocks.
5

Location

If you didn't use the agenda with per-block locations, enter the event address at the end of the form. The app opens the map picker to place the exact marker.

6

Edit an existing event

Go to the event detail → edit icon (available to the organizer and co-organizers). Changes are visible to everyone immediately.

Warning — People who already confirmed "Going" don't get an automatic notification if you change the date or location.
7

Manage co-organizers and special guests

From the event's edit menu, tap "Collaborators". Choose the role before inviting: "Co-organizer" (can edit the event) or "Special guest" (shown featured, no edit rights). Search by name and send the invite.

Educators

Reports & KPIs

How to review your school's metrics and export data for external analysis.

1

Quick metrics strip

At the top of the school admin panel you will see a strip with 3 figures: number of students, average attendance percentage, and paid students over the total.

2

Jump to another month from the KPI strip

Tap the month label in the strip to open a picker and jump directly to any past month.

3

The "Reports" tab

Go to the school panel → "Reports" tab. If you have class groups configured, you can filter the whole report by a specific group using the chips at the top.

4

Choose the format and export

Select "CSV" (to open in Excel or Google Sheets) or "PDF" (to share or print) and tap "Generate report". It includes active students, sessions held, attendance percentage, and per-student payment status.