{"id":14957301,"url":"https://github.com/unllamas/zapcito","last_synced_at":"2025-08-11T02:08:53.546Z","repository":{"id":254499379,"uuid":"846644476","full_name":"unllamas/zapcito","owner":"unllamas","description":"A starter kit for building Nostr clients with Lightning payment.","archived":false,"fork":false,"pushed_at":"2024-10-01T02:41:39.000Z","size":2231,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-02T07:48:47.703Z","etag":null,"topics":["client","hooks","indexeddb","next","nextjs14","nostr","nostr-client","nostr-dev-kit","react","react-hooks"],"latest_commit_sha":null,"homepage":"https://zapcito.app","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/unllamas.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,"zenodo":null}},"created_at":"2024-08-23T16:39:35.000Z","updated_at":"2024-11-03T17:13:42.000Z","dependencies_parsed_at":"2024-08-27T22:54:30.178Z","dependency_job_id":"816a99bb-d907-4591-a522-04a783b399da","html_url":"https://github.com/unllamas/zapcito","commit_stats":{"total_commits":247,"total_committers":1,"mean_commits":247.0,"dds":0.0,"last_synced_commit":"00ec85131b535bf50bb8ef3aee02ab5f1ca5c3a2"},"previous_names":["unllamas/next-nostr-starter-kit","unllamas/zapcito"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/unllamas/zapcito","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unllamas%2Fzapcito","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unllamas%2Fzapcito/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unllamas%2Fzapcito/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unllamas%2Fzapcito/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unllamas","download_url":"https://codeload.github.com/unllamas/zapcito/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unllamas%2Fzapcito/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269819032,"owners_count":24480087,"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","status":"online","status_checked_at":"2025-08-11T02:00:10.019Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["client","hooks","indexeddb","next","nextjs14","nostr","nostr-client","nostr-dev-kit","react","react-hooks"],"created_at":"2024-09-24T13:14:39.007Z","updated_at":"2025-08-11T02:08:53.525Z","avatar_url":"https://github.com/unllamas.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zapcito\n\n![Zapcito](./assets/banner.png)\n\n[![AGPL-3.0 License](https://img.shields.io/github/license/unllamas/zapcito)](https://github.com/unllamas/zapcito/blob/main/LICENSE)\n![Stars](https://badgen.net/github/stars/unllamas/zapcito/?color=yellow)\n\nA starter kit for building [Nostr](https://nostr.com/) clients with Lightning payments.\n\n## 🤓 Tech Stack\n\n- [NextJS](https://nextjs.org/) for web app\n- [Tailwind](https://tailwindcss.com/) for style\n- [Shadcn](https://ui.shadcn.com/) for UI components\n- [LaWallet](https://lawallet.io/) for lightning payments\n\n## 🚀 Get Started\n\nPrerequisites:\n\n- Node v18+\n- PNPM v8+\n\nTo set up the app execute the following commands.\n\n```bash\ngit clone https://github.com/unllamas/zapcito.git\ncd ...\n```\n\n### Installation\n\n```bash\npnpm install\n```\n\nInstall dependencies\n\n```bash\npnpm dev\n```\n\nRuns the app in the development mode.\n\nOpen [http://localhost:3000](http://localhost:3000) to view it in the browser.\n\n```bash\npnpm build\n```\n\n### How to use\n\n[FLOW](https://github.com/unllamas/zapcito/blob/main/FLOW.md)\n\n## 🔐 Environment Variables\n\n\nCreate a `.env` file, or use `.env.example` as an example:\n\n```sh\n# Analytics\nGOOGLE_ANALYTICS_KEY='G-...'\nGOOGLE_TAG_MANAGER_KEY='GTM-...'\n\n# Generic\nSIGNER_RANDOM_PRIV_KEY='Secret key on kex'\n\n# Giphy\nNEXT_PUBLIC_GIPHY_API_KEY='Generate API for Giphy'\n```\n\n## 🗄️ Project Structure\n\nMost of the code lives in the `src` folder and looks something like this:\n\n```sh\nsrc\n├── app\n├── components\n│   └── layouts         # Folder for different layouts\n│   └── ui              # Atomic components\n├── config\n├── features\n├── hooks\n├── lib\n├── store\n├── types\n└── index.(css)\n```\n\nFor `next@^13.x` we recommend using the `features` folder which simulates a `pages` or `screens` folder. This in turn can contain the following structure:\n\n```sh\nfeatures                # Or: page, screen\n└── example\n    └── components      # Example folder\n    └── config          # Example folder\n    └── hooks           # Example folder\n    └── index.(tsx)\n```\n\n## 📋 Roadmap\n\n- [x] Account system\n- [ ] Profile\n    - [x] Get profile\n    - [x] Edit profile\n    - [ ] Follow profile\n    - [ ] Zap profile\n- [ ] Notes\n    - [ ] Publish note\n    - [x] Get notes\n    - [ ] Reaction to note\n    - [ ] Repost note\n- [ ] Lightning Payments\n- [ ] Messages\n- [ ] Badges\n- [ ] Zap goals\n- [ ] Relays\n    - [ ] Add or remove relays\n\n### Supports NIP's \n\n- [x] NIP-01: [Basic protocol](https://github.com/nostr-protocol/nips/blob/master/01.md)\n- [ ] NIP-02: Follow List\n- [x] NIP-05: [Nostr keys to DNS](https://github.com/nostr-protocol/nips/blob/master/05.md)\n- [ ] NIP-17: Private Messages\n- [ ] NIP-18: Reposts\n- [ ] NIP-25: Reactions\n- [ ] NIP-57: Lightning Zaps\n- [ ] NIP-58: Badges\n- [ ] NIP-75: Zap Goals\n- [ ] NIP-96: HTTP File Storage Integration\n\n## License\n\n**Zapcito** is open-source software licensed under the AGPL-3.0 license.\n\n## 🩷 Donations\n\nIf you'd like to support the development of **Zapcito**, please consider donating to the developer.\n\n- ⚡ Zap sats to [dios@lawallet.ar](dios@lawallet.ar)\n\n## 💌 Contact\n\nIf you have any questions or concerns about **Zapcito**, please contact the developer at [npub1em3g0wcfjz5we0gaaelw07fcyqys3fwg42qykw774mvgala424rsl26ytm](https://njump.me/npub1em3g0wcfjz5we0gaaelw07fcyqys3fwg42qykw774mvgala424rsl26ytm).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funllamas%2Fzapcito","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funllamas%2Fzapcito","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funllamas%2Fzapcito/lists"}