{"id":17937775,"url":"https://github.com/store-craft/storecraft","last_synced_at":"2025-07-20T02:12:45.524Z","repository":{"id":225230266,"uuid":"744234337","full_name":"store-craft/storecraft","owner":"store-craft","description":"⭐ Rapidly build AI-powered, Headless e-commerce backends with TypeScript","archived":false,"fork":false,"pushed_at":"2025-06-08T08:58:31.000Z","size":136292,"stargazers_count":491,"open_issues_count":1,"forks_count":26,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-07-03T19:04:51.477Z","etag":null,"topics":["ecommerce","ecommerce-platform","javascript","serverless"],"latest_commit_sha":null,"homepage":"https://storecraft.app","language":"JavaScript","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/store-craft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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-01-16T22:04:57.000Z","updated_at":"2025-07-03T15:50:45.000Z","dependencies_parsed_at":"2024-03-11T12:27:33.497Z","dependency_job_id":"cd086793-f013-4331-b7bc-c544aa262c41","html_url":"https://github.com/store-craft/storecraft","commit_stats":null,"previous_names":["store-craft/storecraft"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/store-craft/storecraft","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/store-craft%2Fstorecraft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/store-craft%2Fstorecraft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/store-craft%2Fstorecraft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/store-craft%2Fstorecraft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/store-craft","download_url":"https://codeload.github.com/store-craft/storecraft/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/store-craft%2Fstorecraft/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266057217,"owners_count":23870124,"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":["ecommerce","ecommerce-platform","javascript","serverless"],"created_at":"2024-10-28T23:07:40.661Z","updated_at":"2025-07-20T02:12:45.513Z","avatar_url":"https://github.com/store-craft.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cdiv style=\"text-align:center\"\u003e\n  \u003cdiv width=\"90%\"\u003e\n    \u003cimg src='https://github.com/store-craft/storecraft/blob/main/packages/docs/public/storecraft-color.svg' \n        width='100%' /\u003e\n  \u003c/div\u003e\n  Rapidly build AI-powered, Headless e-commerce backends with TypeScript and Javascript\n\u003c/div\u003e\u003chr/\u003e\u003cbr/\u003e\n\n![NPM Downloads](https://img.shields.io/npm/d18m/%40storecraft%2Fcore)\n\n[![Core](https://github.com/store-craft/storecraft/actions/workflows/test.core.yml/badge.svg)](https://github.com/store-craft/storecraft/actions/workflows/test.core.yml)\n[![MongoDB](https://github.com/store-craft/storecraft/actions/workflows/test.database-mongodb.yml/badge.svg)](https://github.com/store-craft/storecraft/actions/workflows/test.database-mongodb.yml)[![SQLite / Postgres / MySQL](https://github.com/store-craft/storecraft/actions/workflows/test.database-sql.yml/badge.svg)](https://github.com/store-craft/storecraft/actions/workflows/test.database-sql.yml)\n[![S3 Compatible](https://github.com/store-craft/storecraft/actions/workflows/test.storage-s3-compatible.yml/badge.svg)](https://github.com/store-craft/storecraft/actions/workflows/test.storage-s3-compatible.yml)\n\n[![what](https://img.shields.io/twitter/url?url=https%3A%2F%2Fx.com%2Fshalev_tomer\u0026style=social\u0026label=Storecraft)](https://x.com/shalev_tomer)\n[![](https://img.shields.io/badge/LinkedIn-0077B5?style=flat-square\u0026logo=linkedin\u0026link=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fstore-craft\n)](https://www.linkedin.com/company/store-craft)\n\n# The \u003cimg src='https://github.com/store-craft/storecraft/blob/main/packages/docs/public/storecraft-color.svg' height='24px' style=\"transform: translateY(4px);\" /\u003e mono-repo\n\nHi 👋, `Storecraft` empowers developers to rapidly build AI-powered, Headless e-commerce backends with TypeScript and Javascript.\n\n⭐ AI first, agentic, chat endpoint and similarity search that can serve your customers, and your team. We Supports most of the popular LLMs, and vector stores for similarity search.\n\n⭐ Manage products, collections, orders, customers, auth, emails and more with a powerful programmable api code, REST API, VQL (Virtual Query Language) for powerful queries and similarity search.\n\n⭐ Built in chat endpoint with an agent that serves customers with carts, checkouts and more with PayPal and Stripe.\n\n⭐ Runs on any javascript [platform](https://storecraft.app/docs/backend/platforms/node) (deno, bun, node, cloudflare workers, aws-lambda, google-functions), serverless / serverful\n\n⭐ Connects to any [database](https://storecraft.app/docs/backend/databases/sqlite) (mongo, libsql, sqlite, postgres, mysql, neon, turso, d1, planetscale)\n\n⭐ Uses [storage](https://storecraft.app/docs/backend/storage/s3) (local, r2, s3 compatible, google and more)\n\n⭐ It is [extensible and modular](https://storecraft.app/docs/backend/extensions/overview)\n\n⭐ It is [event based](https://storecraft.app/docs/backend/events)\n\n⭐ Boasts an official [Dashboard](https://storecraft.app/docs/dashboard/overview)\n\n⭐ Well documented [REST-API](https://storecraft.app/docs/rest-api/api) (can also be found in your `/api/reference` endpoint)\n\n\u003chr/\u003e\n\n## **GET STARTED WITH CLI NOW** 👇\n\n```bash\nnpx storecraft create\n```\n\nThis is all the code you need to get started with your own storecraft app.\n\n```js\nconst app = new App({\n  auth_admins_emails: ['tomer.shalev@gmail.com'],\n  general_store_name: 'Wush Wush Games',\n  // ... MORE Mandatory CONFIG\n})\n.withPlatform(new NodePlatform())\n.withDatabase(new LibSQL())\n.withStorage(new NodeLocalStorage('storage'))\n.withMailer(new Resend())\n.withPaymentGateways({\n  paypal: new Paypal({ env: 'test' }),\n  stripe: new Stripe(),\n  dummy_payments: new DummyPayments(),\n})\n.withExtensions({\n  postman: new PostmanExtension(),\n})\n.withAI(\n  new OpenAI({ model: 'gpt-4o-mini'})\n)\n.withVectorStore(\n  new LibSQLVectorStore({\n    embedder: new OpenAIEmbedder(),\n  })\n)\n.withAuthProviders({\n  google: new GoogleAuth(),\n})\n.on(\n  'order/checkout/complete',\n  async (event) =\u003e {\n    // send a team slack message\n  }\n).init();\n\nawait migrateToLatest(app._.db, false);\nawait app._.vector_store?.createVectorIndex();\n\nhttp\n.createServer(app.handler)\n.listen(\n  8000,\n  () =\u003e {\n    app.print_banner('http://localhost:8000');\n  }\n); \n\n```\n\n**Will produce** a server\n\n\u003cdiv style='text-align: center' align=\"center\"\u003e\n  \u003cimg src='https://github.com/store-craft/storecraft/blob/main/packages/docs/public/storecraft-terminal-2.png' \n      width='90%' /\u003e\n\u003c/div\u003e\u003chr/\u003e\u003cbr/\u003e\n\n# Chat with the `storeraft` AI agent\n\nLocated at `/chat`\n\n\u003cdiv style='text-align: center' align=\"center\"\u003e\n  \u003cimg src='https://github.com/store-craft/storecraft/blob/main/packages/docs/public/ai-2.gif' \n      style=\"margin: auto\"\n      width='500px' /\u003e\n\u003c/div\u003e\u003chr/\u003e\u003cbr/\u003e\n\n\u003cdiv style='text-align: center' align=\"center\"\u003e\n  \u003cimg src='https://github.com/store-craft/storecraft/blob/main/packages/docs/public/mobile-stripe.gif' \n      style=\"margin: auto\"\n      width='500px' /\u003e\n\u003c/div\u003e\u003chr/\u003e\u003cbr/\u003e\n\n# Dashboard\n\nLocated at `/dashboard`\n\n\u003cdiv style='text-align: center'\u003e\n  \u003cimg src='https://github.com/store-craft/storecraft/blob/main/packages/docs/public/landing/main.png' \n      width='100%' /\u003e\n\u003c/div\u003e\u003chr/\u003e\u003cbr/\u003e\n\n# API Reference\n\nLocated at `/api` (powered by [Scalar](https://scalar.com))\n\n\n\u003cdiv style='text-align: center'\u003e\n  \u003cimg src='https://github.com/store-craft/storecraft/blob/main/packages/docs/public/landing/reference_api.png' \n      width='100%' /\u003e\n\u003c/div\u003e\u003chr/\u003e\u003cbr/\u003e\n\n# CLI (npx storecraft create)\n\n\u003cdiv style='text-align: center' align=\"center\"\u003e\n  \u003cimg src='https://github.com/store-craft/storecraft/blob/main/packages/docs/public/cli.gif' \n      width='80%' /\u003e\n\u003c/div\u003e\u003chr/\u003e\u003cbr/\u003e\n\n# As seen on MongoDB TV stream\n\n[![Watch on Youtube](https://img.youtube.com/vi/OO4arXfO75U/0.jpg)](https://www.youtube.com/watch?v=OO4arXfO75U)\n\n\n# Dvelopment\n\nThis is a mono repo, where each folder in the `packages` folder is a package, that is published `@npm`.\n\nIt leverages the workspace feature of `npm`\n\nTo start developing a feature first\n\n```bash\nnpm install\n```\n\nThe following is the layout of the packages\n\n### Core ([@storecraft/core](https://github.com/store-craft/storecraft/tree/main/packages/core/))\n\nThe core engine of storecraft\n- core types\n- core API\n- core database types\n- core crypto types\n- core storage types\n- core mailer types\n- core payments types\n- core platform types\n- core VQL types and logic\n- core REST API controller\n\n### 🌐 Platforms [@storecraft/core/platform](https://github.com/store-craft/storecraft/tree/main/packages/core/platform)\n\nSupport for \n- Node\n- Deno\n- Bun\n- Cloudflare workers\n- AWS Lambda\n- Azure Functions\n- Google Functions\n\n### 💾 Databases\n\nSupport for \n- MongoDB ([@storecraft/database-mongo-node](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-mongodb/))\n- SQLite ([@storecraft/database-sqlite](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-sqlite/))\n- Postgres ([@storecraft/database-postgres](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-postgres/))\n- MySQL ([@storecraft/database-mysql](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-mysql/))\n- SQL Base ([@storecraft/database-sql-base](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-sql-base/))\n- Neon (Cloud Postgres, [@storecraft/database-neon](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-neon/))\n- PlanetScale (Cloud Mysql, [@storecraft/database-planetscale](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-planetscale/))\n- Turso / Libsql (Local and Cloud Sqlite, [@storecraft/database-turso](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-turso/))\n- D1 (Cloud Sqlite, [@storecraft/database-cloudflare-d1](https://github.com/store-craft/storecraft/tree/main/packages/databases/database-cloudflare-d1/))\n\n### 📦 Storage\nSupport for,\n- Local storage (Node, Bun, Deno), [@storecraft/core/storage](https://github.com/store-craft/storecraft/tree/main/packages/core/storage/)\n- S3 Compatible ([@storecraft/storage-s3-compatible](https://github.com/store-craft/storecraft/tree/main/packages/storage/storage-s3-compatible/))\n  - Cloudflare R2\n  - AWS S3\n  - DigitalOcean Spaces\n  - MinIO\n- Google Storage ([@storecraft/storage-google](https://github.com/store-craft/storecraft/tree/main/packages/storage/storage-google/))\n\n### 📧 Email Providers\n- Http Mail services [@storecraft/mailer-providers-http](https://github.com/store-craft/storecraft/tree/main/packages/mailers/mailer-providers-http/) \n  - mailchimp support\n  - mailgun support\n  - resend support\n  - sendgrid support\n- node smtp support [@storecraft/mailer-smtp](https://github.com/store-craft/storecraft/tree/main/packages/mailers/mailer-smtp/)\n\n### 💳 Payments \n\n- Stripe [@storecraft/payments-stripe](https://github.com/store-craft/storecraft/tree/main/packages/payments/payments-stripe/)\n- Paypal [@storecraft/payments-paypal](https://github.com/store-craft/storecraft/tree/main/packages/payments/payments-paypal/)\n- You can roll your own (guide [here](https://storecraft.app/docs/backend/checkout-and-payments/roll-your-own))\n\n### Dashboard\n\nThe official dashboard\n- Learn how to use [here](https://storecraft.app/docs/dashboard/overview)\n- The [code](https://github.com/store-craft/storecraft/tree/main/packages/dashboard/), \n  - mount as a component, or\n  - consume from cdn\n\n### Chat\n\nThe official Chat\n- Learn how to use [here](https://storecraft.app/docs/chat/overview)\n- The [code](https://github.com/store-craft/storecraft/tree/main/packages/chat/), \n  - mount as a component, or\n  - consume from cdn\n\n### sdks\n\n- Universal (front/back) Javascript SDK, [@storecraft/sdk](https://github.com/store-craft/storecraft/tree/main/packages/sdk/)\n- React Hooks SDK, [@storecraft/sdk-react-hooks](https://github.com/store-craft/storecraft/tree/main/packages/sdk-react-hooks/)\n\n### Test Runner\n\nTest your app, database, storage and more integrations with\n\n[@storecraft/core/test-runner](https://github.com/store-craft/storecraft/tree/main/packages/core/test-runner/) \n\n### docs\n\nDocs website [code](https://github.com/store-craft/storecraft/tree/main/packages/docs/)\n\n### CLI\n\n```bash\nnpx storecraft create\n```\n\nCLI [code](https://github.com/store-craft/storecraft/tree/main/packages/cli/)\n\n\n### Examples Playground\n\n[Here](https://github.com/store-craft/storecraft/tree/main/packages/playground/) \n\n### Releasing\n\nThe source of truth for the versioning and publishing is the mono-repo version.\nAll the published packages are synced to the mono-repo version. Packages in\nthe mono-repo source code might have different versions but it doesn't matter\nfor the published packages.\n\n#### Versioning\n\nAll versions are synced to the mono-repo version, and are published to npm.\nEach of the commands:\n\n```bash\nnpm run release:version:patch\nnpm run release:version:minor\nnpm run release:version:major\n```\n\nWill,\n\n- Only update the version of the mono-repo.\n- Add a git tag of the version.\n\n#### Publishing\n\nWhen running the command: \n\n```bash\nnpm run release:publish\n```\n\nIt will,\n\n- Update the version of all the packages in the mono-repo to the same version as the mono-repo.\n- Publish all the packages to `npm` with the same version as the mono-repo.\n\n\u003e This can be done in a CI/CD pipeline, or manually.\n\n```text\nAuthor: Tomer Shalev (tomer.shalev@gmail.com)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstore-craft%2Fstorecraft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstore-craft%2Fstorecraft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstore-craft%2Fstorecraft/lists"}