{"id":15085913,"url":"https://github.com/AbdelilahOu/Mahalli","last_synced_at":"2025-09-26T06:31:23.834Z","repository":{"id":214217053,"uuid":"606751788","full_name":"AbdelilahOu/Mahalli-tauri","owner":"AbdelilahOu","description":"Local First Inventory \u0026 invoicing management app built using tauri, vue-3, sqlite, sea-orm/sea-query, shadcn-vue","archived":false,"fork":false,"pushed_at":"2024-11-03T11:32:40.000Z","size":23580,"stargazers_count":24,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-20T02:23:25.084Z","etag":null,"topics":["diesel-cli","diesel-rs","inventory","inventory-management","invoice-generator","rust-lang","sea-orm","sea-query","shadcn","shadcn-vue","sqlite","tauri-app","tsx","typescript","vue3"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AbdelilahOu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2023-02-26T13:14:10.000Z","updated_at":"2024-11-19T04:59:54.000Z","dependencies_parsed_at":"2023-12-26T18:08:50.921Z","dependency_job_id":"536fee74-7dd0-4084-9b97-c8340151c758","html_url":"https://github.com/AbdelilahOu/Mahalli-tauri","commit_stats":null,"previous_names":["abdelilahou/bludgeon-tauri","abdelilahou/mahalli-tauri"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdelilahOu%2FMahalli-tauri","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdelilahOu%2FMahalli-tauri/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdelilahOu%2FMahalli-tauri/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdelilahOu%2FMahalli-tauri/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AbdelilahOu","download_url":"https://codeload.github.com/AbdelilahOu/Mahalli-tauri/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234296353,"owners_count":18809988,"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":["diesel-cli","diesel-rs","inventory","inventory-management","invoice-generator","rust-lang","sea-orm","sea-query","shadcn","shadcn-vue","sqlite","tauri-app","tsx","typescript","vue3"],"created_at":"2024-09-25T07:01:41.062Z","updated_at":"2025-09-26T06:31:23.829Z","avatar_url":"https://github.com/AbdelilahOu.png","language":"Vue","funding_links":[],"categories":["Platforms \u0026 Applications","Applications"],"sub_categories":["Finance"],"readme":"# Mahalli\n\u003cdiv\u003e\n   \u003ca href=\"https://github.com/AbdelilahOu/Mahalli/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release/AbdelilahOu/Mahalli.svg\" alt=\"Latest Release\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\nMahalli is a desktop application for inventory and invoicing, it help you create and manage clients, products, quotes, commands and invoices.\n\n## Video Showcase\n\nCheck out a quick video demonstration of Mahalli's features:\n\n[Watch the Showcase Video](assets/showcase.mp4)\n\n\u003cdiv\u003e\n    \u003cvideo src=\"assets/showcase.mp4\" controls\u003e\u003c/video\u003e\n\u003c/div\u003e\n\n## Built for Moroccan B2B Workflow\n\nMahalli is specifically designed to streamline the business-to-business (B2B) workflow prevalent in Morocco. The typical process involves:\n\n1.  **Quote Generation**: Businesses often start by generating a detailed quote for their clients.\n2.  **Order Creation**: Once the quote is approved, it transitions into an official order.\n3.  **Invoice Generation**: Upon payment or delivery, an invoice is created to finalize the transaction.\n\nMahalli provides comprehensive tools to manage each step of this process efficiently.\n\n## Getting Started\n\nBefore you begin using Mahalli, ensure you have Node.js and npm (Node Package Manager) installed on your system. You can download and install them from the official Node.js website (https://nodejs.org/en/download/package-manager/current).\n\n### Prerequisites for Running Tauri Apps\n\nTauri is the framework used to build Mahalli. Here are the additional requirements for running Tauri applications:\n\ncheck : [tauri prerequisites](https://tauri.app/v1/guides/getting-started/prerequisites/#:~:text=Tauri%20heavily%20depends%20on%20WebView2,and%20version%20for%20your%20system.)\n\n### Running Mahalli\n\n1. Clone the Mahalli repository from GitHub.\n2. Open a terminal and navigate to the root directory of the Mahalli project.\n3. Install the project dependencies by running:\n\n```Bash\nnpm install\n```\n\n4. Start the development server to run Mahalli in development mode:\n\n```Bash\nnpm run tauri dev\n```\n\nThis will launch Mahalli in your default desktop browser.\n\n5. Building Mahalli\n   To create a standalone desktop application for distribution, use the following command:\n\n```Bash\nnpm run tauri build\n```\n\nThis will generate an executable file in the target directory. The specific location and file name will depend on your operating system.\n\n### Understanding the Makefile Commands\n\nThe project also includes a Makefile that defines various commands for managing the Tauri application. Here's a breakdown of some relevant commands:\n\n- migrationsup: Runs database migrations to update the schema (use with caution in production).\n- migrationslast: Reverts the most recent database migration.\n- migrationsdown: Drops all tables and data, essentially resetting the database (use with extreme caution).\n- entity: Generates the sea_orm entities from your database models.\n- dev: Starts the development server.\n- build: Builds a standalone desktop application.\n- check: Runs static code checks on the Rust code.\n- lint: Lints the JavaScript code for potential errors and style issues.\n- migration: Generates a new database migration file:\n\n```bash\nmake migration name=migration_name\n```\n\n- Note: These Makefile commands are typically used during development and may not be directly relevant for casual users of Mahalli.\n\nWe recommend referring to the Tauri documentation (https://tauri.app/) for a more comprehensive understanding of these commands and Tauri development in general.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAbdelilahOu%2FMahalli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAbdelilahOu%2FMahalli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAbdelilahOu%2FMahalli/lists"}