whatisgithub

What is gestschool?

arseniomuanda/gestschool — explained in plain English

Analysis updated 2026-05-18

18PHPAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A Laravel and PHP school management system for handling enrollments, grades, attendance, and reports, free for public and nonprofit schools.

Mindmap

mindmap
  root((repo))
    What it does
      School management
      Enrollments and grades
      Attendance and reports
    Tech stack
      Laravel
      PHP
      Tailwind CSS
    Use cases
      Public schools
      Nonprofits
      Angola education
    Audience
      Developers
      School admins

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Manage a school's full academic year: enrollments, grades, attendance, and report cards in one system

USE CASE 2

Deploy a free system for a public school or nonprofit that cannot afford commercial school software

USE CASE 3

Adapt the Portuguese-language school management structure to another Portuguese-speaking country's education system

USE CASE 4

Try the live demo with preconfigured role accounts before installing locally

What is it built with?

PHPLaravelBladeAlpine.jsTailwind CSSSQLite

How does it compare?

arseniomuanda/gestschoolfoodlz/laravel-ai-skillsbloodyhill/feather
Stars181916
LanguagePHPPHPPHP
Setup difficultymoderatemoderateeasy
Complexity4/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires PHP 8.4+, Composer, and Node.js, or Docker as an alternative setup path.

Free to use for public schools and nonprofit educational institutions, commercial use, resale, and paid services are expressly prohibited.

So what is it?

gestSchool is a web application built to help a school manage an entire academic year in one place: enrollments, grade reports, report cards, attendance, and announcements, without paying for expensive commercial software licenses. It was designed for schools in Angola, covering the local education system's basic and medium levels, but the project describes its structure as generic enough to adapt to other Portuguese speaking education systems. The system covers the practical, day to day work of running a school. It keeps records for students, including personal details, guardians, and enrollment history, and links guardians to the students they are responsible for. It tracks teachers, distinguishing lead teachers from assistants, and staff such as secretaries and pedagogical or general directors. On the academic side, it organizes school years into terms, groups classes and courses, and manages class groups with details like room, shift, capacity, and an assigned homeroom teacher, along with subjects and their curriculum. For day to day teaching, the system records lessons with a summary and planned content, tracks attendance, and manages evaluations per term with configurable weighting, producing grades, grade reports by subject and by class, and individual report cards for each student. Announcements can be sent to specific audiences, such as all users, just teachers, or a single class. Access is controlled through seven preconfigured roles, covering everyone from the general director down to students themselves, each seeing only what is relevant to them. The interface supports both Portuguese and English. It is built with the Laravel framework in PHP, using Blade templates, Alpine.js, and Tailwind CSS on the front end, and SQLite by default for the database, though MySQL and PostgreSQL are also supported. A Docker based setup is offered as an alternative to installing PHP and Node directly. The project also includes seed data that generates a realistic example school with thousands of students, teachers, and records for testing. The license is a custom Public License that allows free use only for public schools and nonprofit educational organizations, explicitly prohibiting commercial use or resale.

Copy-paste prompts

Prompt 1
Help me set up gestSchool locally with Docker following the docs/DOCKER.md guide
Prompt 2
Show me how to add a new user role with Spatie Permissions in this Laravel app
Prompt 3
Help me translate this Portuguese school management app's interface into English
Prompt 4
Explain how the enrollment and grade report models relate to each other in this codebase

Frequently asked questions

What is gestschool?

A Laravel and PHP school management system for handling enrollments, grades, attendance, and reports, free for public and nonprofit schools.

What language is gestschool written in?

Mainly PHP. The stack also includes PHP, Laravel, Blade.

What license does gestschool use?

Free to use for public schools and nonprofit educational institutions, commercial use, resale, and paid services are expressly prohibited.

How hard is gestschool to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is gestschool for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.