{"id":13398794,"url":"https://github.com/hql287/Manta","last_synced_at":"2025-03-14T03:30:32.133Z","repository":{"id":37431496,"uuid":"110584391","full_name":"hql287/Manta","owner":"hql287","description":"🎉 Flexible invoicing desktop app with beautiful \u0026 customizable templates.","archived":false,"fork":false,"pushed_at":"2023-01-04T14:30:25.000Z","size":8628,"stargazers_count":5280,"open_issues_count":133,"forks_count":477,"subscribers_count":103,"default_branch":"dev","last_synced_at":"2024-10-12T05:41:38.558Z","etag":null,"topics":["customizable-templates","electron","electron-app","electron-react","electronjs","freelancer","freelancing","invoice","invoice-generator","invoice-pdf","invoice-template","invoicing-application","invoicing-software","react","react-app","react-redux","reactjs","receipt","taxes","webpack"],"latest_commit_sha":null,"homepage":"https://www.getmanta.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hql287.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-11-13T18:18:40.000Z","updated_at":"2024-10-07T07:42:09.000Z","dependencies_parsed_at":"2023-02-02T15:49:41.888Z","dependency_job_id":null,"html_url":"https://github.com/hql287/Manta","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hql287%2FManta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hql287%2FManta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hql287%2FManta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hql287%2FManta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hql287","download_url":"https://codeload.github.com/hql287/Manta/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221432653,"owners_count":16820051,"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":["customizable-templates","electron","electron-app","electron-react","electronjs","freelancer","freelancing","invoice","invoice-generator","invoice-pdf","invoice-template","invoicing-application","invoicing-software","react","react-app","react-redux","reactjs","receipt","taxes","webpack"],"created_at":"2024-07-30T19:00:31.718Z","updated_at":"2025-03-14T03:30:32.118Z","avatar_url":"https://github.com/hql287.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Invoice","Applications","electron","📦 Legacy \u0026 Inactive Projects","Podcast","Apps","webpack","Accounting \u0026 Invoicing"],"sub_categories":["European VAT","Productivity","Generators","Open Source","⏱️ Productivity (54)"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"128\" alt=\"457761\" src=\"https://github.com/user-attachments/assets/80f92e83-7dcb-4586-9c54-2d6f80fcb501\" alt=\"Manta App Logo\" width=\"180\" height=\"auto\" /\u003e\n\u003c/p\u003e\n\n\u003ch2\u003e\n  Manta\n  \u003ca href=\"https://travis-ci.org/hql287/Manta\"\u003e\n    \u003cimg src=\"https://travis-ci.org/hql287/Manta.svg?branch=dev\" alt=\"Build Status\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/hql287/Manta/releases/tag/v1.1.4\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/version-1.1.4-green.svg\" alt=\"v1.1.4\"\u003e\n  \u003c/a\u003e\n  \u003ca title=\"Crowdin\" target=\"_blank\" href=\"https://crowdin.com/project/manta\"\u003e\n    \u003cimg src=\"https://d322cqt584bo4o.cloudfront.net/manta/localized.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-GPL--3.0-blue.svg\"\u003e\n  \u003c/a\u003e\n\u003c/h2\u003e\n\nA desktop application for creating invoices with beautiful and customizable templates.\n\n\u003ca href=\"#screenshots\"\u003eScreenshots\u003c/a\u003e •\n\u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n\u003ca href=\"#downloads\"\u003eDownloads\u003c/a\u003e •\n\u003ca href=\"#technologies\"\u003eTechnologies\u003c/a\u003e •\n\u003ca href=\"#why\"\u003eWhy?\u003c/a\u003e •\n\u003ca href=\"#goals\"\u003eGoals\u003c/a\u003e •\n\u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e •\n\u003ca href=\"#faq\"\u003eFAQ\u003c/a\u003e •\n\u003ca href=\"#acknowledgement\"\u003eAcknowledgement\u003c/a\u003e\n\n### Screenshots\n\nHere's a few screenshots of Manta. [See more](https://github.com/hql287/Manta/wiki/Screenshots)\n\n![Business Template](https://github.com/user-attachments/assets/199d6705-b248-43f4-b581-84b7e351be32)\n\n![Minimal Template](https://github.com/user-attachments/assets/cd9d3227-41e0-4ff5-aa59-28c7f7055e4e)\n\n![Form](https://github.com/user-attachments/assets/4d17905b-753c-472a-a906-cbba3373527a)\n\n### Translation\n\nDo you speak multiple languages? We need your help!\n\nIf you're interested in translating Manta, please see the [detailed instruction here](https://github.com/hql287/Manta/wiki/Translating-Manta).\nThe following languages are currently being translated, if you would like to Manta to support another language, [please submit your request here](https://github.com/hql287/Manta/issues/9).\n\n* [🇨🇳 中文 (Chinese Simplified)](https://crowdin.com/project/manta/zh-CN#)\n* [🇨🇳 中文 (Chinese Traditional)](https://crowdin.com/project/manta/zh-TW#)\n* [🇩🇪 Deutsch (German)](https://crowdin.com/project/manta/de#)\n* [🇩🇰 Dansk (Danish)](https://crowdin.com/project/manta/da#)\n* [🇪🇸 Español (Spanish)](https://crowdin.com/project/manta/es-ES)\n* [🇫🇷 Français (French)](https://crowdin.com/project/manta/fr#)\n* [🇬🇷 Ελληνικά (Greek)](https://crowdin.com/project/manta/el#)\n* [🇮🇩 Indonesian](https://crowdin.com/project/manta/id#)\n* [🇮🇹 Italiano (Italian)](https://crowdin.com/project/manta/it#)\n* [🇯🇵 日本語 (Japanese)](https://crowdin.com/project/manta/ja#)\n* [🇰🇷 한국어 (Korean)](https://crowdin.com/project/manta/ko#)\n* [🇱🇹 Lietuviškai (Lithuanian)](https://crowdin.com/project/manta/lt#)\n* [🇳🇱 Nederlands (Dutch)](https://crowdin.com/project/manta/nl#)\n* [🇵🇹 Português (Portuguese)](https://crowdin.com/project/manta/pt-PT#)\n* [🇧🇷 Portuguese, Brazilian (Brazil)](https://crowdin.com/project/manta/pt-BR#)\n* [🇷🇺 Русский (Russian)](https://crowdin.com/project/manta/ru#)\n* [🇹🇭 ไทย (Thai)](https://crowdin.com/project/manta/th#)\n* [🇹🇷 Türkçe (Turkish)](https://crowdin.com/project/manta/tr#)\n* [🇻🇳 Việt Nam (Vietnamese)](https://crowdin.com/project/manta/vi)\n\n### Features\n* 🎚 Flexible form. You can turn on/off field and save as default setting.\n* 🏗 Drag \u0026 drop for reordering items. This makes editing easier.\n* 📐 Use SVGs for logo for better printing.\n* 🎨  Custom designed \u0026 highly customizable templates.\n* 🏷 Custom statuses for invoices.\n* 📊 Export PDF for print or email.\n* 🔒Complete Privacy. You financial data stays where it belongs.\n* 💯 Totally Free.\n\n### Downloads\n\nmacOS | Windows | Linux\n-----------------| ---| ---|\n\u003ca href='https://github.com/hql287/Manta/releases/download/v1.1.4/Manta-1.1.4.dmg'\u003eDownload v1.1.4\u003c/a\u003e | \u003ca href='https://github.com/hql287/Manta/releases/download/v1.1.4/Manta.Setup.1.1.4.exe'\u003eDownload v1.1.4\u003c/a\u003e | \u003ca href='https://github.com/hql287/Manta/releases/download/v1.1.4/Manta-1.1.4-x86_64.AppImage'\u003eDownload v1.1.4\u003c/a\u003e |\n\n[More Download Options](https://github.com/hql287/Manta/releases)\n\n#### Supported Platforms\nFollowing platforms are supported by Electron:\n\n**macOS**\nThe minimum version supported is macOS 10.9.\n\n**Windows**\nWindows 7 and later are supported\n\n**Linux:**\n\n- Ubuntu 12.04 and later\n- Fedora 21\n- Debian 8\n\n[More information](https://github.com/electron/electron/blob/master/docs/tutorial/supported-platforms.md).\n\nNote that on Linux, some users might experience a GPU bug where the select options rendered as a black box, see [issue #128 of Manta](https://github.com/hql287/Manta/pull/128) and [issue #4322 of Electron](https://github.com/electron/electron/issues/4322). This can be fixed by disabling hardware acceleration like so:\n\n```sh\nmanta --disable-hardware-acceleration\n```\n\n\u003e Remember that doing this might lead to some degradation of the app's performance. This is why \"the fix\" is not included by default.\n\n### Technologies\n* [Electron](https://github.com/electron/electron)\n* [React](https://github.com/facebook/react)\n* [Redux](https://github.com/reactjs/redux)\n* [React-DnD](https://github.com/react-dnd/react-dnd)\n* [React-Beautiful-DnD](https://github.com/atlassian/react-beautiful-dnd)\n* [React-Motion](https://github.com/chenglou/react-motion)\n* [Webpack](https://github.com/webpack/webpack)\n\n\n### Why\nThe main reason I decided to build this is because I need a simple tool to create good looking invoices, estimates, and receipts but couldn't find one  that suits my needs. I don't do invoicing for a living but I do need it occasionally so an ideal invoicing app just needs to be good at one thing and one thing only, which is making invoices. I really don't need a full-fledged bookkeeping or accounting software.\n\nI believe there are many people such as freelance designers, developers, photographers or writers... also have such need. However, most (if not all) products I found have these these problems:\n\n**Complexity**\n\n* Most invoicing products nowadays is web-based, which means you’ll need to maintain a new account (possible a monthly fee, too) just to create an invoice.\n* Sure, there some open-source products that can be self-hosted, but that will introduce a new layer of complexity to your workflow. Who will setup the product? Who will maintain the server? Who will cover the cost? ...\n* You will always need internet connection to be able to create your invoices. It can be slow sometimes.\n\n**Privacy**\n\n* When you use a web service, most of the time, you’re giving away your data whether you want it or not. Financial data is sensitive and I believe that no one should know about your data except yourself.\n\n\n### Goals\nWith that in mind, I know that Manta would need to satisfy these criteria:\n\n* 🚀 Fast!!!\n* 👍 Friendly UI \u0026 UX\n* 🎉 Has nice looking templates\n* 🔒 Does not touch user’s data\n* 💰 Free! :)\n\n  If you think Manta delivers these, let me know by putting a star on this project 😉\n\n### Development\n\nIt's very easy to get started with these 3 steps:\n\n* Clone this project to your local machine.\n* Open terminal and `cd` into the cloned folder, usually `cd Manta`.\n* Run `yarn install` to install dependencies.\n* Run `yarn dev` in one tab to start `webpack-dev-server`.\n* Run `yarn start` in another tab to open the app.\n\nThis is still in beta and it's far from perfect so feedbacks, issues or PRs are greatly appreciated! :)\n\nNote that on Linux you will need additional dependencies to provide the `icns2png` and `gm` commands.\nUbuntu/Debian users can run: `sudo apt install -y icnsutils graphicsmagick`.\n\n### FAQ\n\n* **Is this app built with Electron?**\n\nYes, it's built on top of [Electron](#). Please see the [Technologies](#technologies) section for more info.\n\n* **What boilerplate did you use**\n\nNone. This is my attempt to integrate Electron with React from scratch. The idea was to get a better understanding of how things work together, especially Webpack.\nBut I do take cue from other projects.\n\n* **What CSS/UI Framework did you use?**\n\nI wrote all the CSS myself. I only use Bootstrap for prototyping at first. But I gradually encapsulate most of the style to the component with the help of [`styled-components`](https://www.styled-components.com/). There is some places still use Bootstrap mostly for layout purpose but I'll get rid of it eventually.\n\n* **Where did you get the icons?**\n\n[ionicons](http://ionicons.com/). They're great!\n\n* **Why did you name the project Manta? It has nothing to do with invoicing.**\n\nIt's actually very common to associate an animal with your brand. There's a reason behind the Twitter bird, the famous MailChimp Freddy or the Docker whale ... It's called the Baby-Face bias. You can read more about it in the book [Designing for Emotion](https://abookapart.com/products/designing-for-emotion) by [Aaron Walter](http://aarronwalter.com/).\nIn my case, I was inspired by the movie [Racing Extinction](http://racingextinction.com/) and by naming this project Manta, I hope to raise people's awareness on some environmental issues mentioned in the movie. You can [read more about it here](https://usemanta.app/about/)\n\n* **I like Manta's logo, did you design it?**\n\nYes, I actually did all the illustrations as well as the templates that you see in the app.\n\n* **Are you available for hire?**\n\nYes, I'm exploring new opportunities at the moment. Please let me know what you have in mind.\n\n* **How do I contact you?**\n\nIf you find an issue, please report it here. For everything else, please drop me a line at hi@usemanta.app\n\n### Acknowledgement\n\nSpecial thanks to [Crowdin](https://crowdin.com) for providing [an open-source license](https://crowdin.com/page/open-source-project-setup-request) for Manta. Feel free to check out [their website](https://crowdin.com/) for more information about this amazing localization management platform.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhql287%2FManta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhql287%2FManta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhql287%2FManta/lists"}