{"id":17198534,"url":"https://github.com/ajnart/subs","last_synced_at":"2025-05-16T00:00:31.465Z","repository":{"id":257826530,"uuid":"870051097","full_name":"ajnart/subs","owner":"ajnart","description":"Subs ! Track your subscriptions easily ","archived":false,"fork":false,"pushed_at":"2025-05-09T10:30:10.000Z","size":2052,"stargazers_count":473,"open_issues_count":4,"forks_count":27,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-11T06:14:46.164Z","etag":null,"topics":["nextjs","react","shadcn-ui","subscriptions-tracker"],"latest_commit_sha":null,"homepage":"https://subs.ajnart.fr/","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/ajnart.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"ajnart","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2024-10-09T11:03:27.000Z","updated_at":"2025-05-10T05:07:42.000Z","dependencies_parsed_at":"2024-11-06T21:18:53.087Z","dependency_job_id":"900185c6-9af9-4f77-9334-23616f7a8b51","html_url":"https://github.com/ajnart/subs","commit_stats":{"total_commits":56,"total_committers":3,"mean_commits":"18.666666666666668","dds":0.0535714285714286,"last_synced_commit":"f2f1912af1993719c1ecf2c6a1c5e7c00af42926"},"previous_names":["ajnart/subs"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajnart%2Fsubs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajnart%2Fsubs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajnart%2Fsubs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajnart%2Fsubs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ajnart","download_url":"https://codeload.github.com/ajnart/subs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254442854,"owners_count":22071877,"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":["nextjs","react","shadcn-ui","subscriptions-tracker"],"created_at":"2024-10-15T02:00:54.741Z","updated_at":"2025-05-16T00:00:31.294Z","avatar_url":"https://github.com/ajnart.png","language":"TypeScript","funding_links":["https://ko-fi.com/ajnart"],"categories":["TypeScript","react","Platforms \u0026 Applications"],"sub_categories":[],"readme":"# Subs - Simplistic Open Source Subscription Cost Tracker\n\nSubs is a lightweight application designed to help you track and manage your subscription costs across different services. With a clean and intuitive interface, it simplifies the process of monitoring your recurring expenses.\n\n## Features\n\n- **Track Subscriptions**: Add, edit, and delete subscription details including name, price, and currency\n- **Automatic Favicon Fetching**: Visual identification of your subscriptions with icons from their domains\n- **Multi-Currency Support**: Track subscriptions in different currencies with automatic conversion rates\n- **Total Cost Calculation**: See your total monthly expenses at a glance\n- **Import/Export**: Easily back up your subscription data or move it between devices\n- **Client-Side Storage**: Option to store data in your browser for privacy or use SQLite for persistence\n- **Responsive Design**: Works seamlessly on both desktop and mobile devices\n\n## Demo\n\nYou can try out Subs without installing anything at [subs.ajnart.fr](https://subs.ajnart.fr)\n\n![Demo GIF](https://github.com/user-attachments/assets/ffb88333-6c4d-46c9-9ca7-49602106e5f1)\n\n## Tech Stack\n\nSubs is built with modern web technologies:\n\n- **Framework**: Remix (React)\n- **Styling**: Tailwind CSS with Shadcn UI components\n- **State Management**: Zustand\n- **Package Manager**: Bun\n\n## 🚀 Installation\n\n### 🌐 Use the Online Version\n\nVisit [subs.ajnart.fr](https://subs.ajnart.fr) to use the tool immediately without installation.\n\n### 🐳 Run with Docker\n\nRun with a single command:\n\n```bash\ndocker run -p 7574:7574 -v ./data:/app/data --name subs --rm ghcr.io/ajnart/subs\n```\n\nThen visit `http://localhost:7574` in your browser.\n\n### 📦 Using Docker Compose\n\nCreate a `docker-compose.yaml` file:\n\n```yaml\nservices:\n  subs:\n    image: ghcr.io/ajnart/subs\n    container_name: subs\n    ports:\n      - \"7574:7574\"\n    restart: unless-stopped\n    # volumes: Optional: Uncomment to use a volume to save data outside of the default docker volume\n      # - ./data:/app/data\n    # environment:\n      # - USE_LOCAL_STORAGE=true  # Uncomment to use browser storage instead of file storage (different config for each browser)\n```\n\nThen run:\n\n```bash\ndocker-compose up -d\n```\n\nOpen [http://localhost:7574](http://localhost:7574) in your browser to see the webui\n\n\u003e [!NOTE]\n\u003e Data is stored in the `/app/data` directory inside the container. Mount this directory as a volume to persist your data between container restarts.\n\n\n\n## Contributing\n\nContributions are welcome! Feel free to open issues or submit pull requests to help improve Subs.\n\n## License\n\nThis project is open-source and available under the MIT License.\n\n---\n\nThank you for your interest in Subs! We hope it helps you keep better track of your subscription costs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajnart%2Fsubs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajnart%2Fsubs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajnart%2Fsubs/lists"}