{"id":38702124,"url":"https://github.com/adamsnows/vizinn","last_synced_at":"2026-01-17T10:50:09.960Z","repository":{"id":282640305,"uuid":"949219042","full_name":"adamsnows/vizinn","owner":"adamsnows","description":"An innovative platform that connects users in specific regions for buying, selling, and offering services in a practical and secure way. Our goal is to strengthen the local economy and create a reliable environment for transactions between neighbors and nearby communities.","archived":false,"fork":false,"pushed_at":"2025-05-15T15:15:26.000Z","size":5955,"stargazers_count":6,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-15T15:48:14.203Z","etag":null,"topics":["community","dev","js","open","python","source","ts","work","workflow"],"latest_commit_sha":null,"homepage":"https://vizinn.com.br","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adamsnows.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-03-15T23:59:26.000Z","updated_at":"2025-05-15T15:15:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"cb5a0e41-e695-4cbc-bdc4-5be51bf484e7","html_url":"https://github.com/adamsnows/vizinn","commit_stats":null,"previous_names":["vizinn-app/readme","vizinn-app/monorepo","vizinn-app/app","adamsnows/vizinn"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/adamsnows/vizinn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamsnows%2Fvizinn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamsnows%2Fvizinn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamsnows%2Fvizinn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamsnows%2Fvizinn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adamsnows","download_url":"https://codeload.github.com/adamsnows/vizinn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamsnows%2Fvizinn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28506593,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T10:25:30.148Z","status":"ssl_error","status_checked_at":"2026-01-17T10:25:29.718Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["community","dev","js","open","python","source","ts","work","workflow"],"created_at":"2026-01-17T10:50:09.860Z","updated_at":"2026-01-17T10:50:09.932Z","avatar_url":"https://github.com/adamsnows.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\n\u003cimg src=\"https://github.com/user-attachments/assets/53998944-43fc-4a23-8e45-cbb4d691c2c0\" alt=\"image\" /\u003e\n\u003c/p\u003e\n\n**Vizinn** is an innovative, open-source platform that connects users in specific regions for buying, selling, and offering services in a practical and secure way. Our goal is to strengthen the local economy and create a reliable environment for transactions between neighbors and nearby communities. We welcome contributors from all backgrounds. Whether you're a seasoned developer or just starting out, this project offers a fantastic opportunity to collaborate and make a real impact.\n\n- 📚 Learn modern technologies in a real-world application\n- 👥 Collaborate with a community of developers\n- 📝 Build a meaningful addition to your professional portfolio\n- 🌐 Make an impact on local communities through technology\n\nWe believe in transparent, collaborative development and look forward to your contributions! \u003cbr/\u003e\nFor a detailed contribution guide, check out our [CONTRIBUTING](https://github.com/adamsnows/vizinn/blob/main/CONTRIBUTING.md) guide.\u003cbr/\u003e\nFor information about frontend-backend connectivity, see our [FRONTEND_BACKEND_DOCUMENTATION](https://github.com/adamsnows/vizinn/blob/main/FRONTEND_BACKEND_DOCUMENTATION.md).\n### [See or create an issue!](https://github.com/vizinn-app/app/issues)\n\n## 🎨 Design\n\nCheck out our design prototype in Figma:\n- [Vizinn Design](https://www.figma.com/design/EqwjF3jl0oSDI873mcgwA7/vizinn?node-id=69-7\u0026t=qG45NxpPBtFXYDMH-1)\n\n**Note:** The Figma design requires access permission. Please request access and the project owner will manually grant it to you.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/f12c2d12-181a-4f49-800f-fc9eaccc1804\" alt=\"image\" /\u003e\n\u003c/p\u003e\n\n\n## 👾  Socials\n\nIf you wish to support this initiative or be part of the project, contact us:\n\n- 🔗  **[Discord](https://discord.gg/GkfDbTY6xu)**\n- 🔗  **[WhatsApp Group](https://chat.whatsapp.com/IkF1YGczvQGL9wxRxp8O7K)**\n\n## 💼 Market Impact\n\n**Vizinn** is poised to transform local economies and community interactions in significant ways:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/e40e02ea-1410-4389-b536-73750d60443d\" alt=\"image\" /\u003e\n\u003c/p\u003e\n\n\n### 🌱 Economic Impact\n- **Stimulate Local Commerce**: Reduce economic leakage by keeping transactions within communities\n- **Empower Small Entrepreneurs**: Lower barriers to entry for micro-entrepreneurs and service providers\n- **Reduce Transport Costs**: Minimize logistics expenses by facilitating hyperlocal transactions\n- **Create New Market Opportunities**: Enable service providers to reach customers in their immediate vicinity\n\n\n\n### 👥 Social Impact\n- **Strengthen Community Bonds**: Foster connections between neighbors who might otherwise never interact\n- **Increase Safety and Trust**: Create a verified marketplace with accountability through the rating system\n- **Reduce Environmental Footprint**: Decrease carbon emissions by encouraging local consumption\n- **Bridge Digital Divide**: Provide technological access to local markets for all community members\n\n### 🚀 Innovation Potential\n- **Data-Driven Insights**: Generate valuable data about local commerce patterns\n- **Scalable to Different Contexts**: Adaptable to various settings from condominiums to university campuses\n- **Integration with Local Services**: Potential to connect with local delivery networks and payment systems\n- **Community-Led Development**: Features can evolve based on specific community needs\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/79099157-9295-4023-99e9-91dcbbfd2aa2\" alt=\"image\" /\u003e\n\u003c/p\u003e\n\n\n\nBy addressing these market gaps, **Vizinn** represents not just an app but a paradigm shift in how we think about community commerce and neighborhood interactions.\n\n## 🚀 Initial Focus\n\n- Users can define their area of interest, allowing transactions within their condominium or in strategic locations such as universities, shopping centers, and specific neighborhoods.\n\n## 📌 Main Features\n- ✅ **Exclusive Marketplace** – Users in nearby regions can post listings and make purchases.\n- 🌟 **Featured Listings** – Users can pay to highlight their listings and increase visibility.\n- 📍 **Smart Location Filters** – Search for products and services within your condominium or specific areas.\n- 🔄 **Exchange and Donation Area** – Encouraging circular economy within communities.\n- 🏢 **Building Manager Panel** – Announcements and event organization.\n- ⭐ **Ratings and Reputation** – Feedback system to increase trust between users.\n- 🔒 **Security and Moderation** – Reporting inappropriate listings and identity validation.\n- 💳 **Integrated Payment Option** – Facilitating secure transactions within the app.\n- 📢 **Specific Requests** – Users can publish specific demands, such as \"I want lunch at UFRN.\"\n\n## 🛠 Technologies Used\n\n### **Front-End (TypeScript)**\n- ⚛ **React Native** – Framework for building native mobile apps.\n- 📱 **Expo** – Platform for universal React applications.\n- 🚀 **Ignite** – Boilerplate for accelerated development.\n- 🎨 **NativeWind (TailwindCSS)** – Efficient and optimized styling for React Native.\n- 🔗 **Axios** – Efficient HTTP requests.\n- 📲 **React Navigation** – Flexible navigation system.\n\n### **Back-End (Python)**\n- ⚡ **FastAPI** – Modern and high-performance framework for APIs.\n- 🗄 **SQLAlchemy** – ORM for SQL databases.\n- 🔐 **JWT** – Secure authentication.\n- 🏦 **SQLite/PostgreSQL** – Scalable and reliable database.\n- 🔧 **Alembic** – Database migration tool.\n- 📊 **Pydantic** – Data validation and settings management.\n\n### **Other Technologies**\n- 🔔 WebSockets for real-time updates.\n- 🚀 CI/CD for automated deployment.\n- 📦 PNPM for monorepo package management.\n- 🐍 Poetry for Python dependency management.\n\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/29286fcd-2117-4695-81f0-99d7ac246c05\" alt=\"image\" /\u003e\n\u003c/p\u003e\n\n\n## Monorepo Structure\n\nThis monorepo contains the following packages:\n\n- `apps/backend`: Python API with FastAPI\n- `apps/frontend-app`: React Native mobile application\n- `apps/shared-ui`: UI utilities shared between projects\n\n## 🚀 Contributing\n\nWe welcome contributions to the Vizinn project! Contributing to this project not only helps us build something amazing, but also provides you with valuable experience in modern development practices and technologies.\n\n### Why Contribute to Vizinn?\n\n- Gain experience with modern tech stack (React Native, FastAPI, etc.)\n- Build your portfolio with meaningful open source contributions\n- Connect with a community of developers\n- Learn collaborative development workflows\n- Make a positive impact on local communities\n\n### Contribution Workflow\n\n1. **Fork the repository** to your own GitHub account\n2. **Clone your fork** to your local machine:\n   ```bash\n   git clone https://github.com/YOUR-USERNAME/vizinn-app.git\n   cd vizinn\n   ```\n3. **Set up the project** by following the installation instructions below\n4. **Create a branch** for your feature or bug fix:\n   ```bash\n   git checkout -b feature-name\n   ```\n5. **Make your changes** and commit them with clear, descriptive messages:\n   ```bash\n   git commit -m \"Add feature: description of your changes\"\n   ```\n6. **Push to your fork**:\n   ```bash\n   git push origin feature-name\n   ```\n7. **Open a pull request** to the main repository\n\n### Contribution Guidelines\n\n- Before starting work, check the issues and existing PRs to avoid duplication\n- Follow the code style and conventions used in the project\n- Write clear commit messages\n- Include tests and documentation for your changes\n- Keep PRs focused on a single feature or fix\n\n### Becoming a Contributor\n\nOnce your PR is accepted:\n- You'll be given the \"contributor\" role on our Discord server\n- Your name will be added to our contributors list\n- You'll have the opportunity to become a regular maintainer\n\n## Requirements\n\n- Node.js \u003e= 18.0.0\n- pnpm \u003e= 8.0.0\n- Python \u003e= 3.13\n- Poetry (for managing backend dependencies)\n\n## Installation\n\n```bash\n# Install monorepo dependencies\npnpm install\n\n# Install backend dependencies (Python)\ncd apps/backend\npoetry install\n```\n\n## Running the Project\n\nTo run the Vizinn project, you need to start both the frontend and backend servers. The simplest way is to run these commands in separate terminal windows:\n\n### Start the Frontend\n\n```bash\n# Navigate to the project root and run:\nnpm run dev:frontend\n\n```\n\n### Start the Backend\n\n```bash\n# Navigate to the project root and run:\nnpm run dev:backend\n\n```\n\n### Running Both Together\n\nIf you want to run both servers simultaneously, you can use:\n\n```bash\n# Run all services in parallel\nnpm run dev\n\n```\n\n### Build\n\n```bash\n# Build React Native app\npnpm build:app\n\n# Build all packages\npnpm build\n```\n\n### Linting and Testing\n\n```bash\n# Lint React Native app\npnpm lint:app\n\n# Test React Native app\npnpm test:app\n```\n\n## Adding New Dependencies\n\nTo add dependencies to a specific package:\n\n```bash\n# Example for any package\npnpm --filter \u003cpackage-name\u003e add \u003cdependency-name\u003e\n```\n\nTo add development dependencies:\n\n```bash\npnpm --filter \u003cpackage-name\u003e add -D \u003cdependency-name\u003e\n```\n\n## Using Shared Packages\n\nTo use shared packages in other projects:\n\n```bash\n# Add shared-ui package to any project\npnpm --filter \u003cproject-name\u003e add \"shared-ui@workspace:*\"\n```\n\n## Creating New Shared Packages\n\nUse the available script to easily create new shared packages:\n\n```bash\n./create-shared-package.sh package-name \"Package description\"\n```\n\n## Managing the Backend\n\nThe backend uses Poetry for Python dependency management:\n\n```bash\n# Inside the packages/backend folder\npoetry add \u003cpackage-name\u003e\n\n# Run the FastAPI server\npoetry run uvicorn backend.app:app --reload\n```\n\nFor detailed backend setup instructions, see the [backend README](/apps/backend/README.md).\n\n## 🛠️ VS Code Workspace Setup\n\nTo enhance your development experience, we provide a VS Code workspace configuration that automatically sets up your project structure and opens multiple terminals for development.\n\n### Required Extension\n\nBefore using the workspace configuration, install the following VS Code extension:\n\n- **Restore Terminals** - [manuth/vscode-restore-terminals](https://marketplace.visualstudio.com/items?itemName=EthanSK.restore-terminals)\n  - This extension automatically opens and configures your terminal sessions when you open the workspace.\n\n### How to Use the Workspace\n\n1. Open the project in VS Code by clicking on the `workspace.code-workspace` file in the root directory.\n2. Alternatively, you can open it from the command line:\n   ```bash\n   code workspace.code-workspace\n   ```\n\n3. This will set up your workspace with the following structure:\n   - \"Vizinn Root\" - The root directory of the project\n   - \"Frontend\" - The frontend application\n   - \"Backend\" - The backend API\n\n### Automatic Terminal Configuration\n\nWith this configuration, when you open the workspace, three terminals will automatically open:\n\n1. **App Terminal** - Executa o servidor backend (`npm run dev:backend`)\n2. **App Server** - Executa o aplicativo frontend (`npm run dev:frontend`)\n3. **Monorepo Root** - Terminal na raiz do projeto para comandos gerais\n\n### Workspace Configuration\n\nIf you want to customize the workspace configuration, you can edit the `workspace.code-workspace` file. Here's what the current configuration looks like:\n\n\n\u003e **Note**: You may need to adjust the file paths in the commands to match your specific project location.\n\n```json\n{\n  \"folders\": [\n    {\n      \"path\": \".\",\n      \"name\": \"Vizinn Root\"\n    },\n    {\n      \"path\": \"./apps/frontend-app\", // Adjust to match current structure\n      \"name\": \"Frontend\"\n    },\n    {\n      \"path\": \"./apps/backend\",\n      \"name\": \"Backend\"\n    }\n  ],\n  \"settings\": {\n    \"restoreTerminals.artificialDelayMilliseconds\": 700,\n    \"restoreTerminals.keepExistingTerminalsOpen\": false,\n    \"restoreTerminals.runOnStartup\": true,\n    \"restoreTerminals.terminals\": [\n      {\n        \"splitTerminals\": [\n          {\n            \"name\": \"App Terminal\", // Backend Terminal\n            \"commands\": [\n              \"cd ~/Projects/vizinn\",\n              \"npm run dev:backend\" // Starts the FastAPI Server\n            ]\n          },\n          {\n            \"name\": \"App Server\", // Frontend Terminal\n            \"commands\": [\n              \"cd ~/Projects/vizinn\",\n              \"npm run dev:frontend\" // Starts React Native app with Expo\n            ]\n          },\n          {\n            \"name\": \"Monorepo Root\", // Additional terminal for other commands\n            \"commands\": [\n              \"cd ~/Projects/vizinn\",\n              \"git pull\"\n            ]\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n\n\n## 📚 Learning Resources\n\nTo help you get started with the technologies used in this project, we've compiled a list of useful resources:\n\n### React Native \u0026 Expo\n- [React Native Official Documentation](https://reactnative.dev/docs/getting-started)\n- [Expo Documentation](https://docs.expo.dev/)\n- [React Navigation Guide](https://reactnavigation.org/docs/getting-started/)\n- [NativeWind (TailwindCSS for React Native)](https://www.nativewind.dev/quick-starts/expo)\n\n### FastAPI \u0026 Python\n- [FastAPI Official Documentation](https://fastapi.tiangolo.com/)\n- [SQLAlchemy Tutorial](https://docs.sqlalchemy.org/en/20/tutorial/index.html)\n- [Poetry Documentation](https://python-poetry.org/docs/)\n- [Python Type Hints Guide](https://mypy.readthedocs.io/en/stable/cheat_sheet_py3.html)\n\n### Monorepo \u0026 pnpm\n- [pnpm Workspace Guide](https://pnpm.io/workspaces)\n- [Monorepo Best Practices](https://monorepo.tools/)\n\n### Development Workflows\n- [GitHub Flow](https://docs.github.com/en/get-started/quickstart/github-flow)\n- [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/)\n- [Pull Request Best Practices](https://github.blog/2015-01-21-how-to-write-the-perfect-pull-request/)\n\n## 🚀 Recent Updates\n\n### May 18, 2025\n- Fixed frontend-backend connectivity issues\n- Configured PostgreSQL local database connection\n- Resolved CORS configuration issues\n- Fixed endpoint URL formats for all API calls (added trailing slashes)\n- Created unified documentation for frontend-backend connection\n- Increased API timeout for registration process\n- Implemented retry mechanism for handling API timeouts\n- Added detailed error messages for common connectivity issues\n\n### May 14, 2025\n- Added comprehensive backend documentation\n- Improved monorepo structure and package management\n- Added Poetry configuration for Python dependency management\n- Enhanced script commands for better development experience\n- Updated monorepo package.json with more complete metadata and scripts\n- Added Python 3.13 requirement\n\n## Transforming Neighborhoods, Connecting People!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamsnows%2Fvizinn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamsnows%2Fvizinn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamsnows%2Fvizinn/lists"}