{"id":21509715,"url":"https://github.com/hdoro/gororobas","last_synced_at":"2025-04-09T17:10:36.064Z","repository":{"id":237928139,"uuid":"795506665","full_name":"hdoro/gororobas","owner":"hdoro","description":"Collaborative agroecology wiki \u0026 social network - winner of Gel Data 2024 hackathon (form. EdgeDB)","archived":false,"fork":false,"pushed_at":"2025-04-04T22:50:29.000Z","size":11152,"stargazers_count":22,"open_issues_count":36,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-09T17:10:34.391Z","etag":null,"topics":["agroecology","edgedb","effects","nextjs","tailwindcss","tiptap"],"latest_commit_sha":null,"homepage":"https://gororobas.com/hackathon","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hdoro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"hdoro"}},"created_at":"2024-05-03T12:36:48.000Z","updated_at":"2025-04-04T22:50:32.000Z","dependencies_parsed_at":"2024-10-31T23:22:56.229Z","dependency_job_id":"09da4450-9d49-47a2-b22a-2c02728e6f77","html_url":"https://github.com/hdoro/gororobas","commit_stats":null,"previous_names":["hdoro/agroecology-wiki-edgedb-hackathon"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hdoro%2Fgororobas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hdoro%2Fgororobas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hdoro%2Fgororobas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hdoro%2Fgororobas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hdoro","download_url":"https://codeload.github.com/hdoro/gororobas/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248074973,"owners_count":21043490,"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":["agroecology","edgedb","effects","nextjs","tailwindcss","tiptap"],"created_at":"2024-11-23T21:30:13.879Z","updated_at":"2025-04-09T17:10:36.058Z","avatar_url":"https://github.com/hdoro.png","language":"TypeScript","readme":"# Gororobas, collaborative agroecology wiki\n\n![Screenshot of the app](./public/default-og.png)\n\n✨ The app is live at: https://gororobas.com\n\nThis is a Typescript project built leveraging the following technologies:\n\n- [Gel](https://geldata.com): database and authentication\n- [NextJS](https://nextjs.org) and [React](https://react.dev/): frontend frameworks\n- [Vercel](https://vercel.com): deployment\n- [TailwindCSS](https://tailwindcss.com), [RadixUI](https://www.radix-ui.com/) and [Shadcn/UI](https://ui.shadcn.com/): styling and component primitives\n- [Effect](https://effect.website): typescript tooling for more robust and type-safe code\n- [OpenTelemetry](https://opentelemetry.io) and [Honeycomb](https://honeycomb.io): observability\n- [Sanity.io](https://sanity.io): image storage and CDN\n- [Mailpit](https://mailpit.axllent.org/docs/install/): email server for local development\n- [Tiptap](https://tiptap.dev): rich text editor\n- [react-hook-form](https://react-hook-form.com): form state management\n- [dnd-kit](https://dndkit.com): drag and drop for lists in form\n- [pnpm](https://pnpm.io): package manager\n- [Biome](https://biomejs.dev): linter and prettifier\n- [lint-staged](https://github.com/lint-staged/lint-staged) and [husky](https://typicode.github.io/husky/): pre-commit hooks to ensure everything is OK\n- [Bun](https://bun.sh): Javascript runtime for faster local development\n\n## Introduction to the project\n\n![Screenshot of the app](./public/presentation-peek.png)\n\nYou can learn about the project's motivation, tech stack, approach and learnings here: https://gororobas.com/hackathon\n\n## Developing locally\n\n1. Start by populating the `.env.example` file with the necessary environment variables. You can copy it to `.env.local` and fill in the values.\n   - If you're connected to the Vercel project, you can use `vercel env pull` to build the production `.env` file.\n1. In order to authenticate with emails locally, you need to install and run [Mailpit](https://mailpit.axllent.org/docs/install/). This will allow the Gel server to send emails via your local Mailpit server.\n   - 💡 You can still authenticate with Google oAuth without it\n1. To connect to a local database, [install Gel](https://docs.geldata.com/learn/cli#installation) to your machine\n1. Run `pnpm install` to install the dependencies\n1. In a separate terminal, run `gel project init` to start an Gel instance for the current config\n1. Run `gel ui` to open the Gel Studio\n1. Then, in the same Gel terminal, run `gel watch` to have it watch changes to your schema\n1. After Gel has applied the necessary migrations, run `bun run generate:all` to have the types and our custom EdgeQL SDK generated. This is necessary to interact with the database and the project won't run without it.\n1. After generating types, run `bun run auth:setup` to configure Gel with the proper authentication settings\n1. Finally, run `bun run dev` to start the development server and access the app at `http://localhost:3000`\n\n## Deploying the app and database\n\n1. Log into Gel Cloud in your terminal with `gel cloud login`\n1. Migrate the current database schema to the cloud with `gel migrate -I ORG/INSTANCE_NAME`\n1. If you're starting a new cloud instance, you can seed it with a local dump of data with:\n   ```sh\n   gel dump \u003cyour-dump.dump\u003e\n   gel restore -I \u003corg\u003e/\u003cinstance-name\u003e \u003cyour-dump.dump\u003e\n   ```\n1. If you're setting up a Vercel project for it the first time, refer to the [official guide on deploying to Vercel](https://docs.geldata.com/guides/tutorials/nextjs_app_router#deploying-to-vercel)\n1. When you push a commit to main, Vercel will automatically build and deploy it to `gororobas.com` or whatever the domain for the new project you've set up\n\n## Credits\n\nPeople involved in this creation:\n\n- [henrique doro](https://hdoro.dev) - design and development\n- [angie cepeda](https://www.instagram.com/angiedeandes/) - content and photography\n- Daniel Mundim Porto Pena - for his work on [Sistematização e planejamento de sistemas agroflorestais no bioma Cerrado](https://repositorio.ufu.br/handle/123456789/30942), which we used to populate a subset of the database\n\n## Contributing\n\nIf you'd like to contribute to the project, please open an issue or a pull request. We're open to suggestions and improvements but aren't sure how they'll pan out yet 🙂\n\n## License\n\nThis project is licensed under the Apache 2.0 License. You can read more about it in the [LICENSE](./LICENSE) file.\n\n## Restaurando backups\n\nA partir do backup baixado no S3:\n\n1. Instale o GPG:\n   - Windows: `winget install GnuPG.GnuPG`\n   - MacOS: `brew install gpg`\n   - Linux: `sudo apt-get install gpg`\n1. Decodifique a encriptação do backup com: `gpg --decrypt --output decrypted_backup.dump.gz input_file.dump.gpg `\n   - A chave de encriptação é a mesma que foi usada para criar o backup\n1. Descompacte o backup: `gunzip decrypted_backup.dump.gz`\n1. Restaure o backup: `gel restore decrypted_backup.dump` localmente, ou `gel restore -I ORG/INSTANCE_NAME decrypted_backup.dump` na nuvem\n","funding_links":["https://github.com/sponsors/hdoro"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhdoro%2Fgororobas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhdoro%2Fgororobas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhdoro%2Fgororobas/lists"}