{"id":13558397,"url":"https://github.com/Aardwolf-Social/aardwolf-social","last_synced_at":"2025-04-03T13:31:11.942Z","repository":{"id":37178819,"uuid":"106940525","full_name":"Aardwolf-Social/aardwolf-social","owner":"Aardwolf-Social","description":"Powering connected social communities with open software.","archived":false,"fork":false,"pushed_at":"2025-03-21T20:37:52.000Z","size":18095,"stargazers_count":500,"open_issues_count":16,"forks_count":45,"subscribers_count":33,"default_branch":"main","last_synced_at":"2025-03-31T15:11:53.380Z","etag":null,"topics":["aardwolf","activitypub","activitystreams","decentralized","federated","fediverse","hacktoberfest","hacktoberfest-accepted","hacktoberfest2024","mastodon","rust","rust-lang","social","social-media","social-network","social-plattforms"],"latest_commit_sha":null,"homepage":"https://aardwolf.social","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aardwolf-Social.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-14T15:47:57.000Z","updated_at":"2025-03-15T07:12:20.000Z","dependencies_parsed_at":"2023-02-06T10:31:11.056Z","dependency_job_id":"e52fbaf5-81f5-4df0-9bd3-9324b566f6bd","html_url":"https://github.com/Aardwolf-Social/aardwolf-social","commit_stats":{"total_commits":790,"total_committers":34,"mean_commits":"23.235294117647058","dds":"0.42911392405063287","last_synced_commit":"b2960d7457e19e0bb3732ad9aadce9425455c8d6"},"previous_names":["aardwolf-social/aardwolf-social","aardwolf-social/aardwolf"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aardwolf-Social%2Faardwolf-social","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aardwolf-Social%2Faardwolf-social/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aardwolf-Social%2Faardwolf-social/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aardwolf-Social%2Faardwolf-social/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aardwolf-Social","download_url":"https://codeload.github.com/Aardwolf-Social/aardwolf-social/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247009549,"owners_count":20868567,"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":["aardwolf","activitypub","activitystreams","decentralized","federated","fediverse","hacktoberfest","hacktoberfest-accepted","hacktoberfest2024","mastodon","rust","rust-lang","social","social-media","social-network","social-plattforms"],"created_at":"2024-08-01T12:04:55.763Z","updated_at":"2025-04-03T13:31:11.935Z","avatar_url":"https://github.com/Aardwolf-Social.png","language":"Rust","funding_links":[],"categories":["Rust","mastodon"],"sub_categories":[],"readme":"# Aardwolf Social\n**Powering connected social communities with open-source software**\n\n[![Aardwolf-Social/build](https://github.com/Aardwolf-Social/aardwolf/actions/workflows/aardwolf-build.yml/badge.svg)](https://github.com/Aardwolf-Social/aardwolf/actions/workflows/aardwolf-build.yml)\n[![Aardwolf-Social/test](https://github.com/Aardwolf-Social/aardwolf/actions/workflows/aardwolf-test.yml/badge.svg)](https://github.com/Aardwolf-Social/aardwolf/actions/workflows/aardwolf-test.yml)\n![GitHub issues](https://img.shields.io/github/issues/Aardwolf-Social/aardwolf)\n[![rust-clippy analyze](https://github.com/Aardwolf-Social/aardwolf/actions/workflows/rust-clippy.yml/badge.svg)](https://github.com/Aardwolf-Social/aardwolf/actions/workflows/rust-clippy.yml)\n[![Docker Image CI](https://github.com/Aardwolf-Social/aardwolf/actions/workflows/docker.yml/badge.svg)](https://github.com/Aardwolf-Social/aardwolf/actions/workflows/docker.yml)\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](http://www.gnu.org/licenses/agpl-3.0)\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Aardwolf Social: Powering connected social communities with open software\" src=\"/doc/images/aardwolf-banner_solid-bg.png\" /\u003e\n\u003c/p\u003e\n\n## 🌐 About Aardwolf Social\n\n**Aardwolf Social** is a free and open-source alternative to Facebook that prioritizes user privacy and decentralization. Unlike mainstream platforms that present a single advertising-driven experience, Aardwolf empowers individuals and communities to create unique, customizable spaces while maintaining the ability to interact across different instances.\n\n- **User Privacy First**: No ads, no tracking—just a community-first social experience.\n- **Decentralized \u0026 Customizable**: Each community can have its own Aardwolf server (instance) that fits its specific needs.\n- **Open Source**: Built by the community for the community.\n\n---\n\n## 📂 Project Structure\n\n| Folder/File                  | Description                                       |\n|------------------------------|---------------------------------------------------|\n| `.github/`                    | CI/CD Files related to GitHub                     |\n| `aardwolf-actix/`             | The Actix backend Rust application code           |\n| `aardwolf-models/`            | Web app models and database setup files           |\n| `aardwolf-templates/`         | Legacy frontend files                             |\n| `aardwolf-test-helpers/`      | Development functional test code                  |\n| `aardwolf-types/`             | Additional web app components                     |\n| `aardwolf-yew-frontend/`      | The Yew frontend application code                 |\n| `config/`                     | Aardwolf Social app configuration files           |\n| `doc/`                        | Documentation                                     |\n| `docker/`                     | Docker files                                      |\n| `po/`                         | Legacy directory for i18n translations            |\n| `src/`                        | The source directory for the main app             |\n| `tests/`                      | Code validation and coverage tests                |\n| `build.rs`                    | Rust code that directs Cargo build                |\n| `Cargo.lock`                  | Complete manifest of all Rust crates used         |\n| `Cargo.toml`                  | Manifest of crates required to build Aardwolf     |\n| `CODE_OF_CONDUCT.md`          | Our Code of Conduct rules                         |\n| `db-init.sh`                  | Part of the setup/install scripts                 |\n| `diesel.toml`                 | Tells Diesel where to find the SQL migrations     |\n| `LICENSE`                     | The license we use for this software              |\n| `README.md`                   | The file you are presently reading                |\n| `ROADMAP.md`                  | Our development roadmap                           |\n| `rust-toolchain.toml`         | Specifies the Rust version for the dev environment|\n| `SECURITY.md`                 | Future info for security updates                  |\n| `translations/`               | Translations directory (links to `aardwolf-templates`) |\n\n---\n\n## 🌍 Screenshot of Aardwolf Social\n\nCheck out a preview of the homepage design below! This static demo showcases our design approach and upcoming features.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Aardwolf Social: Powering connected social communities with open software\" src=\"/doc/images/homepage-demo.png\" /\u003e\n\u003c/p\u003e\n\n---\n\n## 🤝 Contributing to Aardwolf Social\n\nWe would love your help! Whether you’re an experienced developer or just starting, there’s a place for you in the Aardwolf community. Here are some ways to contribute:\n\n- **Rust Developers**: If you're proficient in or learning Rust, we need your expertise to improve our backend.\n- **Frontend Developers**: Help us design a beautiful and functional user interface using HTML, CSS, and Yew.\n- **Documentation**: Proofread, organize, and update our documentation.\n- **Docker \u0026 VMs**: Assist in building Docker images for development environments.\n\n### How to Contribute\n\nFollow these steps to start contributing to Aardwolf Social:\n\n1. **Fork the Repository**:\n   - Navigate to the main repository [Aardwolf Social GitHub Repo](https://github.com/Aardwolf-Social/aardwolf).\n   - Click the **Fork** button in the upper right corner to create a copy of the repository under your GitHub account.\n\n2. **Clone the Repository**:\n   - Open your terminal and clone the forked repository to your local machine:\n     ```bash\n     git clone https://github.com/YOUR-USERNAME/aardwolf.git\n     cd aardwolf\n     ```\n\n3. **Create a New Branch**:\n   - Before making any changes, create a new branch for your feature or fix. This keeps your contributions organized and separate from the main codebase:\n     ```bash\n     git checkout -b feature-name\n     ```\n\n4. **Make Your Changes**:\n   - Add your contributions, whether it’s code, documentation, or other improvements. Once you're happy with your changes, stage and commit them:\n     ```bash\n     git add .\n     git commit -m \"Description of your changes\"\n     ```\n\n5. **Push the Changes to Your Fork**:\n   - Push the changes from your local machine to your forked repository:\n     ```bash\n     git push origin feature-name\n     ```\n\n6. **Create a Pull Request (PR)**:\n   - Go to your forked repository on GitHub, and you should see a prompt to **Compare \u0026 pull request**.\n   - Click that, and make sure you're merging into the **main** branch of the original `Aardwolf-Social/aardwolf` repository.\n   - Provide a clear title and description for your pull request so that maintainers can easily understand your changes.\n\n7. **Wait for Feedback**:\n   - A project maintainer will review your PR. They may ask for changes or approve it. Feel free to discuss or clarify anything in the PR comments.\n\n### Additional Contribution Resources\n\n- Check out our [contributor guidelines](/CONTRIBUTING.md) for detailed rules and tips.\n- View our [development roadmap](/ROADMAP.md) to see current priorities and future plans.\n\n---\n\n## 📂 Repositories\n\nAardwolf Social is divided into several repositories:\n\n- **[Aardwolf-Social Main](https://github.com/Aardwolf-Social/aardwolf)**: The main project repository.\n- **[Aardwolf Social Interface](https://github.com/Aardwolf-Social/aardwolf-interface)**: The frontend development repository.\n- **[Aardwolf Social Website](https://github.com/Aardwolf-Social/aardwolf-website)**: Repository for the Jekyll-powered website.\n\n---\n\n## 📬 Contact Us\n\nHave questions or want to join the conversation? We’re available on several platforms:\n\n- **Matrix Chat Room**: [#aardwolf-discussion:matrix.org](https://matrix.to/#/#aardwolf-discussion:matrix.org)\n- **Mastodon**: [@banjofox2@hackers.town](https://hackers.town/@banjofox2)\n\n---\n\n## 🌟 Community Code of Conduct\nAardwolf Social is dedicated to fostering a welcoming and supportive community. We expect all contributors to follow our [Code of Conduct](/CODE_OF_CONDUCT.md) both online and offline. Let's build something amazing together!\n\n---\n\n## 📜 License\nAll Aardwolf Social software is licensed under the [GNU Affero General Public License (AGPL v3)](http://www.gnu.org/licenses/agpl-3.0).\n\n---\n\n**Join Us in Building a More Open and Connected World with Aardwolf Social!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAardwolf-Social%2Faardwolf-social","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAardwolf-Social%2Faardwolf-social","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAardwolf-Social%2Faardwolf-social/lists"}