{"id":27455605,"url":"https://github.com/resuite/recoin","last_synced_at":"2026-03-14T16:52:52.634Z","repository":{"id":285771210,"uuid":"957887330","full_name":"resuite/recoin","owner":"resuite","description":"Localfirst finance tracker for income and expenses.","archived":false,"fork":false,"pushed_at":"2025-04-07T05:11:59.000Z","size":149,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-14T23:02:43.204Z","etag":null,"topics":["golang","localfirst","pwa","retend","scss","typescript","web"],"latest_commit_sha":null,"homepage":"https://recoin.pages.dev","language":"TypeScript","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/resuite.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2025-03-31T09:56:50.000Z","updated_at":"2025-04-08T16:52:45.000Z","dependencies_parsed_at":"2025-04-02T16:21:45.279Z","dependency_job_id":"c9ec25cc-5b95-4024-a779-6e315bdeeb35","html_url":"https://github.com/resuite/recoin","commit_stats":null,"previous_names":["adebola-io/recoin","resuite/recoin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resuite%2Frecoin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resuite%2Frecoin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resuite%2Frecoin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resuite%2Frecoin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/resuite","download_url":"https://codeload.github.com/resuite/recoin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249110863,"owners_count":21214411,"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":["golang","localfirst","pwa","retend","scss","typescript","web"],"created_at":"2025-04-15T16:44:18.527Z","updated_at":"2026-03-14T16:52:52.576Z","avatar_url":"https://github.com/resuite.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# recoin\n\nrecoin is an open-source, local-first finance tracker designed to empower individuals to take control of their financial data. It is built with Go, Bun, Vite, Retend, and Supabase.\n\n\u003e This project is a work in progress and is not yet ready for production use.\n\n## Project Structure\n\nThis project is a monorepo managed with workspaces, containing the following applications:\n\n- `apps/api`: A backend API built with Go, responsible for data management and API endpoints.\n- `apps/site`: The frontend website built with Vite, TypeScript, Sass, and Retend, providing the user interface.\n\n## Getting Started\n\n### Prerequisites\n\nEnsure you have the following installed:\n\n- [Bun](https://bun.sh/)\n- [Go](https://go.dev/) (for the API)\n\n### Running the Site Locally\n\n1. **Install dependencies:**\n\n   ```bash\n   bun install\n   ```\n\n2. **Start the development server:**\n\n   ```bash\n   bun run site:dev\n   ```\n\n   This will launch the Vite development server for the `apps/site` application, typically accessible at `http://localhost:5229`.\n\n### Running the API Locally\n\n1. **Start the API server:**\n\n   ```bash\n   bun run api:dev\n   ```\n\n   This command navigates to the `apps/api` directory and runs the Go application using `go run main.go`. Ensure Go is correctly installed and configured.\n\n## Environment Variables\n\nThe API and site rely on environment variables for configuration, managed via `.env` files.\n\n### API (`apps/api`)\n\nCreate a `.env` file in the `apps/api` directory with the following variables:\n\n- `SUPABASE_API_URL`: **Required**. The URL for your Supabase project API.\n- `SUPABASE_SERVICE_ROLE_KEY`: **Required**. The service role key for your Supabase project.\n- `PORT`: Optional. The port the API server will run on (defaults to `3000`).\n- `FRONTEND_URL`: Optional. The URL of the frontend application, used for CORS configuration.\n\n### Site (`apps/site`)\n\nCreate a `.env` file in the `apps/site` directory (or use `.env.development`, `.env.production`) with the following variable:\n\n- `VITE_API_URL`: **Required**. The full URL where the backend API (`apps/api`) is running (e.g., `http://localhost:3000`).\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature/your-feature-name`).\n3. Make your changes.\n4. Commit your changes (`git commit -am 'Add some feature'`).\n5. Push to the branch (`git push origin feature/your-feature-name`).\n6. Create a new Pull Request.\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresuite%2Frecoin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fresuite%2Frecoin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresuite%2Frecoin/lists"}