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.
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.
Create your account
When you open the app you will see the screen "Create account — Join the capoeira community". Fill in your first name, last name, optional nickname, and email. You can also register with Google.
Complete the onboarding
After registration, the onboarding screen guides you to add a profile photo and find your group or school. You can skip this step and do it later, but linking from the start activates all community features.
Link your group
On the home screen you will see the card "No group assigned" with a "Find groups" button. Search for your group in the directory and send a join request. You can also ask your educator to add you directly from their school admin panel.
General
Home & discovery
How to navigate the main screen and find what you need quickly.
The Home screen
The "Home" tab shows a personalized greeting with your name, your group card, and the "Upcoming events" section with your community's events in chronological order. A red badge on the "Profile" tab indicates pending notifications.
Filter upcoming events
In the "Upcoming events" section you will find filter chips: "This week" and "This month". Tap them to narrow the view.
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.
The "+" button (Educators)
If you are an educator, you will see a floating "+" button on the Home screen. Tap it to open a menu with three options: "New event", "Create group", and "Create school".
Global map of schools
In the "Groups" tab you will find an interactive map with all registered schools worldwide. Tap any marker to see the school name, its group, and its schedules. Useful for finding a place to train when traveling.
General
Groups & community
How to discover groups, join one, and explore your community's hierarchy.
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.
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.
A group's profile
Tap any group to see its full profile organized in tabs: "Summary" (description and stats), "Events" (upcoming group events), "Hierarchy" (educator tree), "Schools" (active schools list), and "Graduations" (belt system).
Request to join a group
From the group profile, tap "Request to join the group". Your request will show the badge "Request pending" until the admin approves it. You will receive a notification in "Profile → Notifications" when accepted.
View the group hierarchy
In the "Hierarchy" tab of the group profile you will find the full educator tree. You can search by name within the hierarchy. Tap any educator to see their public profile.
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.
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.
Filter by category and more
Tap "Filters" to open advanced options: Category (batizado, roda, open roda, troca de corda, course, class, workshop, seminar, festival, meetup, intensive, training), Price (free or paid), Format (in-person or online), Dates, Group, and Location.
Event detail
Tap any event to see the full description, date and time, map location, event type, organizers, and poster if it has one. You will also see how many people are going ("Going") and how many marked interest ("Interested").
Confirm "Going" or "Interested"
From the event detail, tap "Interested" to save it to your list, or "Going" to confirm attendance. Organizers can see the total count for both.
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.
The three profile tabs
The "Profile" tab has three internal sections: "Summary" (your upcoming events and bio), "Notifications" (pending requests from group, school, or educator), and "Management" (if educator, access to your schools; if student, the schools where you train).
Edit your profile
Tap the edit icon (pencil) on your profile photo or name to open the edit form. You can change your photo, first name, last name, and nickname. Save by tapping "Save".
Your belt and graduations
Your current belt appears with its color and name below your name in the profile. If you have more than one recorded graduation, tap your belt to see the full history with the date of each level change.
Settings: language and theme
From "Profile", tap "Settings". There you can change the language (English, Spanish, Portuguese) in the "Language" section, and the visual theme (light or dark) in "App mode". Changes apply immediately.
Pending notifications
In the "Notifications" tab of your profile you will see five types of requests: "Group join request" (someone wants to join your group), "Educator request" (educator-student relationship request), "School join request" (someone wants to join your school), "School transfer request" (pending administration transfer), and "Collaboration request" (invitation to co-organize an event). The red badge on the "Profile" tab shows how many you have unread.
Report a problem
Go to "Profile" → "Settings" → "Report a problem". Your report goes directly to the development team with technical device information attached automatically.
Practitioners
Joining a school
How to find a nearby school, send a request, and what happens next.
Find a school on the map
Go to the "Groups" tab and use the interactive map to explore schools near you. Tap any marker to see the name, group, schedules, and the option to view the full profile.
Request to join with "Guided join request"
From the school profile, tap "Guided join request". You can include a message to introduce yourself to the educator. Your request will appear in the "Requests" section of the school panel.
Wait for approval
Your request stays as "Pending" until the educator approves or rejects it. You will receive a notification in "Profile → Notifications" when there is a response.
Access your classes and tracking
Once approved, the school appears in "Profile" → "Management" tab. There you will see your month-by-month attendance history and your payment status if the school manages fees.
Practitioners
Your personal history
How to view your monthly attendance, your graduations, and the events you attended.
This month's attendance
Go to "Profile" → "Management" tab → your school. You will see your attendance percentage for the current month and the list of classes with a present or absent indicator for each.
Graduation history
From your profile, tap your current belt to expand the full history with the date of each level change. The record is permanent and publicly visible on your profile.
Payment status
If your school manages payments, in the "Management" tab you will see your payment status for the month: "Pending", "Paid", or "Overdue". Only the educator can record your payments.
Confirmed events
In the "Summary" tab of your profile you will see upcoming events you confirmed "Going" to. You can view the detail of each one by tapping the event name directly from your profile.
Educators
Creating your group
How to register your capoeira group on the platform and configure its information.
Access the creation form
Tap the floating "+" button on the Home screen → "Create group". You can also go to the "Groups" tab and tap "Create group" in the top corner.
Name and description
Enter your group's official name and a description. Both are required. The name will appear in the global directory, on member profiles, and on all events you organize.
Capoeira style (required)
In the "Capoeira style *" field, type the style you practice (e.g. Mixed, Benguela, Angola, Regional). It is a free-text field and it is required. This text is used as the name of your graduation system and shapes how your belts are labeled.
Group logo (optional)
Upload your group logo from your gallery. It will appear on the group profile, in schools, and on the group card that your students see on the Home screen.
Create the group
Tap "Create". If the name is not a duplicate, the group is created immediately. The app will ask if you want to set up the graduation system now or later.
Invite members
After creating the group, share its name with your students. They search for it in the "Groups" tab → directory and request to join. You can also add them directly from your school admin panel, or they can link during their own onboarding.
Educators
Managing your group
How to manage members, admin roles, and group information.
Group administration panel
Go to your group profile and tap the administration button (visible only to admins and co-admins). You will access options for managing members, roles, and group configuration.
Approve or reject join requests
In "Requests" on the group panel you will see pending requests with the applicant's name and their message if they used the guided request. Tap "Approve" or "Reject" to respond to each one.
Assign roles: admin and co-admin
From a member's profile in the group panel, you can assign them the "Co-admin" role (panel access) or promote them to "Admin". You can also use the "Leave admin" option to remove the role.
Edit group information
Go to the group profile → edit icon. You can change the name, description, logo, capoeira style, and city. Changes apply immediately and are reflected in the public directory.
Remove a member
From the member list in the panel, tap a member's name and choose "Remove from group". The member loses access to group content but retains their graduation history.
Educators
Educational supervision
How to assign a supervising educator for your school's students and how the hierarchy works.
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 when they are in different cities or countries.
Automatic supervision (same school)
If the supervisor and students share the same school, supervision is automatic. The app will show the "Same school" badge on the student's profile inside the supervisor's panel.
Manual supervision (outside the school)
If the supervisor is in a different school, you can assign them manually. On the supervision screen, tap "Select supervising educator" and search by name. Supervised students will show the "Outside your school" badge.
View the supervision tree
The supervision tree is visible in the "Hierarchy" tab of the group profile. It shows the relationships between educators and which students are under each one's supervision — the "mestre to apprentice" tree of your group.
Educators
Creating your school
How to create your school, place it on the map, and set up training schedules.
Access the creation form
Tap the floating "+" button on the Home screen → "Create school". You can also go to the "Groups" tab → your group's profile → "Schools" tab → "Create school" button.
Fill in the name and location
Complete the required fields: "School name" (e.g. Downtown School), "Location" (full address of your training venue), "Country", and "City".
Add training schedules
In the "Training schedules" section, tap "Add schedule". Select the weekday, start time, and end time. Add as many schedules as you need. At least one schedule is required to create the school.
Create the school
Tap "Create school". If all fields are complete, the school is created and will appear on the global map and in the directory. You will be taken automatically to the school's admin panel.
Edit or deactivate
To edit the name, address, or schedules, go to the school profile → edit icon. If you stop training at that location, you can deactivate the school so it doesn't appear in the directory without losing the history.
Educators
Co-educators
How to add co-educators to your school and manage their permissions.
What a co-educator is
A co-educator is an educator from the same group who helps manage your school. They have access to the admin panel: they can record classes, mark attendance, and register payments, but cannot change school configuration or transfer administration.
Add a co-educator
Go to your school profile → "Co-educators" section → tap "Add co-educator". Search for the educator by name (they must be a member of the same group with the Educator role). Tap their name and confirm.
Remove a co-educator
In the "Co-educators" section of the school profile, tap the co-educator's name and choose "Remove co-educator". The action is immediate and the educator loses access to the school panel.
Leave the co-educator role
If you are a co-educator at a school and no longer want to be, go to the school profile → "Co-educators" section → "Leave co-educator role". You can also do this from "Profile → Management → [school name]" → "Leave role".
Transfer school administration
To hand full school control to another educator, go to the school profile → "Transfer administration". The recipient must be an active co-educator of the school.
Educators
School join requests
How to manage join requests to your school from the admin panel.
View pending requests
Go to your school profile → "Manage" button → "Requests" tab. You will see all pending join requests. Each card shows the applicant's name, photo, date, and the message they sent (if they used the guided request).
Approve a request
Tap "Approve" on the applicant's card. The student will receive a notification that they were accepted and will start appearing in your student list. You can assign them to a class group immediately from the "Students" tab.
Reject a request
Tap "Reject" on the applicant's card. The student will receive a notification that their request was not approved.
Processed requests history
Below the pending requests you will find the history of already-processed requests: approved (badge "Accepted") and rejected (badge "Rejected"). Processed requests remain in the history and cannot be deleted.
Educators
Students & class groups
How to view your students, add members without accounts, and organize them by class group.
The school admin panel
Access it from "Profile" → "Management" tab → your school, or from the school profile by tapping the admin button. You will find four tabs: "Students", "Attendance", "Payments", and "Reports".
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. If there are no members, the app shows "No members".
Add a student without an account (ghost member)
Scroll down in the "Students" tab to the "Students without account" section. Tap "Add student" to manually register a student who doesn't use the app. Enter their name and basic details.
Create and manage class groups
Access the school management (gear icon or "Manage" button). There you can create class groups — sets of students organized by schedule. Create one per time slot (e.g. "Mon & Wed 7pm") and assign students to each.
View an individual student's profile
Tap any student's name to see their profile: name, belt, current month attendance percentage, month-by-month attendance history, and payment record.
Educators
Attendance tracking
How to record today's class, mark present and absent, and review history.
Record today's class
In the school admin panel → "Attendance" tab, you will see "No classes this month yet" if it's the first one. Tap "Record today's class" to open the session form.
Select schedule and class group
In the session form, select today's schedule (one of the ones you configured when creating the school) and the corresponding class group. The app will automatically load the students for that group.
Mark present and absent
Tap each student's name to toggle between present (✓ green) and absent. The list shows the selected class group's students first, then the rest of the school, so groups don't mix.
Save the class
Tap "Save class". The app shows a confirmation dialog with the present and absent counts. Tap "Confirm" to record the session to the cloud. Each student's attendance percentage updates automatically.
Review previous sessions
In the "Attendance" tab, sessions appear in chronological order. Tap any past session to see the full detail: who was present, who was absent, and the date and time of the record.
Educators
Payments & treasury
How to record monthly fees, track who owes, and export reports.
The "Payments" tab
In the school admin panel, go to the "Payments" tab. Each student appears with their current month's payment status: "Pending", "Paid", "Paid (late)", "Overdue", or "Free". Statuses are calculated automatically by date.
Record a student payment
Tap the student's name in the "Payments" tab and then tap "Record payment". Enter the amount and select the corresponding month. The student's status immediately changes to "Paid".
See who has pending or overdue payments
In the "Payments" tab list you can see all students' statuses at a glance. "Pending" and "Overdue" statuses are highlighted. You will also see the configured payment due day.
Generate and export the monthly report
Go to the "Reports" tab of the school panel. Select the format (CSV for Excel or Google Sheets, or PDF to print or share) and tap "Generate report".
Educators
Graduation system
How to set up your group's belts and record level changes.
Access the graduation system
Go to your group's profile → "Graduations" tab. If no levels are configured yet, you will see "No graduation levels defined" and a "Set up system now" button.
Create a belt level
Tap "Add level" or "Create Level". Enter the belt name (e.g. "Green-Yellow Belt"), select the colors that compose it, and indicate whether it has painted tips and how many. Save the level.
Organize by category
Levels are organized automatically into sections: "Adult System", "Youth System", "Children's System", "Trainee Instructors", and "Special Levels". Assign the correct category when creating or editing each level.
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.
Assign a graduation
In the group profile → "Graduations" → "Assign graduation". Find the student, select the new level and date. The change is recorded permanently in the student's history and the new belt appears on their profile immediately.
View a student's graduation history
Tap any group member's name. Their profile shows the current belt with its color. Tap the belt to see the full history: every level change with date. The history cannot be deleted.
Educators
Create & manage events
How to publish a batizado, roda, or workshop for the community to see.
Create an event
Tap the floating "+" button on the Home screen → "New event". You can also go to the "Events" tab and tap "New Event" in the top corner.
Fill in the event details
The form includes: event name, category (batizado, roda, open roda, troca de corda, course, class, workshop, seminar, festival, meetup, intensive, or training session), date, start time, and end time.
Add a description and poster
Enter the description with all relevant details (price, requirements, what to bring, etc.). Upload a cover image (poster) from your gallery to give the event visibility.
Pin the location on the map
Enter the event address. The app opens the map picker where you can drag the marker to the exact location. Attendees will see the location and can open navigation directly from the event.
Manage co-organizers and attendees
After creating the event, you can add co-organizers in the edit menu → "Collaborators". Co-organizers can edit the event and see the full list of who marked "Going" or "Interested".
Educators
Reports & KPIs
How to review your school's metrics and export data for external analysis.
Quick metrics strip
At the top of the school admin panel you will see a KPI strip: number of students, classes held this month, average attendance percentage, number of students paid, and number overdue.
The "Reports" tab
Go to the school panel → "Reports" tab. The subtitle reads "Attendance, payments and school statistics". This is where you generate the monthly report with all consolidated information.
Choose the report format
Select the format you need: "CSV" to open in Excel or Google Sheets for custom analysis, or "PDF" for a ready-to-share or print document.
Generate and export
Tap "Generate report". The app creates the file with a monthly summary: active students, sessions held, overall attendance percentage, and per-student payment status. You can share it directly from the export screen.