{"id":15596325,"url":"https://github.com/solobarine/correo","last_synced_at":"2026-04-11T14:32:40.305Z","repository":{"id":205562385,"uuid":"711466764","full_name":"Solobarine/correo","owner":"Solobarine","description":"A Full Stack Application for Posting and Viewing Post. See more on the Readme.","archived":false,"fork":false,"pushed_at":"2023-11-05T09:18:21.000Z","size":143,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-03-29T11:42:08.650Z","etag":null,"topics":["javascript","laravel","php","postgresql","tailwindcss"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Solobarine.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-29T11:05:31.000Z","updated_at":"2023-11-07T02:20:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"874fbdd9-0753-42c4-ad7c-b5c2f63977a9","html_url":"https://github.com/Solobarine/correo","commit_stats":{"total_commits":65,"total_committers":1,"mean_commits":65.0,"dds":0.0,"last_synced_commit":"c7f00cce1a9cca102d9db90b4844be222a43a9ce"},"previous_names":["solobarine/correo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Solobarine/correo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solobarine%2Fcorreo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solobarine%2Fcorreo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solobarine%2Fcorreo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solobarine%2Fcorreo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Solobarine","download_url":"https://codeload.github.com/Solobarine/correo/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solobarine%2Fcorreo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260927747,"owners_count":23084084,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","laravel","php","postgresql","tailwindcss"],"created_at":"2024-10-03T01:03:49.207Z","updated_at":"2025-12-30T22:29:08.240Z","avatar_url":"https://github.com/Solobarine.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Correo\n\nCorreo is a versatile social post app designed to foster meaningful interactions among users. It provides a range of features that include user authentication, post creation, like and dislike functionality, commenting, profile management, and email notifications. This document serves as a comprehensive guide to understanding and deploying the Correo application.\n\n## Table of Contents\n\n-   [Features](#features)\n-   [Technologies Used](#technologies-used)\n-   [Getting Started](#getting-started)\n    -   [Prerequisites](#prerequisites)\n    -   [Installation](#installation)\n-   [Configuration](#configuration)\n-   [Usage](#usage)\n-   [Backend Functionalities](#backend-functionalities)\n-   [Author](#authors)\n-   [Contributing](#contributing)\n-   [License](#license)\n\n## Features\n\nCorreo boasts a broad spectrum of features that enhance the user experience:\n\n-   **User Authentication:** Correo ensures a secure user registration and login system that protects user data and privacy.\n\n-   **Post Creation:** Users can create engaging posts with titles and rich content. Express your thoughts, experiences, or ideas with ease.\n\n-   **Like and Unlike Posts:** Interact with other users' posts by liking or unliking them, fostering engagement and feedback.\n\n-   **Commenting:** Users can leave comments on posts, encouraging discussion and community-building.\n\n-   **Post and Comment Deletion:** Maintain control over your content by deleting your own posts and comments.\n\n-   **Profile Viewing:** Get to know your fellow users by viewing their profiles. You can also check your own profile to see your posts and activity.\n\n-   **Email Notifications:** Users receive timely email notifications on successful registration, login, post likes, and comments.\n\n-   **Pagination:** Manage large numbers of posts and comments effectively with the use of pagination, ensuring smooth navigation and performance.\n\n-   **Policies for Authorization:** Implement robust authorization policies to control and manage user actions, providing a secure and trusted environment.\n\n-   **Reusable Components:** Create a seamless and consistent user interface using reusable components, improving overall design and usability.\n\n-   **Route-Model Binding:** Simplify the retrieval and manipulation of data from the database with Laravel's route-model binding.\n\n-   **Email Sending using Mailtrap:** Utilize Mailtrap for email testing and debugging, guaranteeing reliable email delivery to users.\n\n## Technologies Used\n\nCorreo leverages a stack of modern technologies to deliver an efficient and robust user experience:\n\n-   **PHP:** The backbone of the application, PHP is used to develop server-side logic, facilitating seamless data processing.\n\n-   **Laravel:** A powerful PHP web application framework, Laravel is used to create feature-rich web applications that offer scalability and maintainability.\n\n-   **JavaScript:** Employed on the client side to enhance interactivity, JavaScript is essential for creating dynamic user experiences.\n\n-   **Tailwind CSS:** A utility-first CSS framework, Tailwind CSS helps design a modern and responsive user interface.\n\n-   **Postgres:** PostgreSQL, often referred to as Postgres, is a powerful open-source relational database management system (RDBMS). It is known for its advanced features, extensibility, and a strong focus on data integrity\n\n-   **Mailtrap:** This tool for email testing and debugging is integrated to manage email notifications, ensuring accurate email delivery to users.\n\n## Getting Started\n\nTo deploy Correo on your local development environment, follow these instructions:\n\n### Prerequisites\n\nBefore installing Correo, make sure you have the following software installed on your system:\n\n-   PHP 8.0 or higher\n-   Composer (PHP package manager)\n-   Laravel CLI\n-   Node.js and NPM (Node Package Manager)\n-   Git\n-   A database (e.g., Postgres, MySQL, MongoDB)\n\n### Installation\n\n1. Clone the Correo repository to your local system:\n\n    ```bash\n    git clone https://github.com/yourusername/correo.git\n    ```\n\n2. Navigate to the project directory:\n\n    ```bash\n    cd correo\n    ```\n\n3. Install PHP dependencies using Composer:\n\n    ```bash\n    composer install\n    ```\n\n4. Install JavaScript dependencies using NPM:\n\n    ```bash\n    npm install\n    ```\n\n5. Create a .env file by copying the example:\n\n    ```bash\n    cp .env.example .env\n    ```\n\n6. Generate an application key:\n\n    ```bash\n    php artisan key:generate\n    ```\n\n7. Configure your .env file to set up the database and email settings.\n\n    - Run database migrations:\n\n        ```bash\n        php artisan migrate\n        ```\n\n    - Start the development server:\n\n        ```bash\n        php artisan serve\n        ```\n\n8. Access the application in your web browser at this [localhost port](http://localhost:8000)\n\n## Configuration\n\nFor a smooth setup and operation of Correo, take care of the following configurations:\n\n-   Database Configuration: In the .env file, provide the necessary details for connecting to your database.\n\n-   Mail Configuration: Configure the email settings, including the use of Mailtrap or your preferred email service.\n\n-   Pagination Configuration: Adapt pagination settings within controllers and views as needed for efficient content management.\n\n## Usage\n\nTo start using Correo:\n\n-   Register a new account or log in using an existing one.\n\n-   Create posts, like and comment on posts, and view user profiles.\n\n-   Stay updated with email notifications for various activities.\n\n## Backend Functionalities\n\nCorreo incorporates various backend functionalities for seamless operation:\n\n**User Authentication:** The application employs Laravel's built-in authentication system, ensuring that user registration and login are secure and reliable.\n\n**Policies for Authorization:** Policies and gates are set up to control user actions, allowing for appropriate management of posts and comments.\n\n**Pagination:** Laravel's pagination features are utilized to effectively handle large datasets, guaranteeing user-friendly navigation.\n\n**Reusable Components:** Blade templates and components are used to establish a consistent and reusable user interface for a cohesive design.\n\n**Route-Model Binding:** Laravel's route-model binding simplifies the retrieval and manipulation of data, making data management efficient.\n\n**Email using Mailtrap:** Mailtrap is integrated for testing and debugging email functionality, ensuring a seamless email experience.\n\n## Authors\n\n**Solomon Barine Akpuru**\n\n-   [github handle](https://github.com/solobarine)\n-   [linkedin handle](https://linkedin.com/in/solomon-akpuru)\n\n## Contributing\n\nIf you're interested in contributing to Correo, we welcome your input. Please refer to our contribution guidelines to get started.\n\n## License\n\nThis project is licensed under the MIT License. Feel free to use, modify, and distribute the code according to the terms of the license.\nView the License [Here](./LICENSE).\n\nHappy Posting!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolobarine%2Fcorreo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolobarine%2Fcorreo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolobarine%2Fcorreo/lists"}