[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-7724":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":34,"readmeContent":35,"aiSummary":36,"trendingCount":16,"starSnapshotCount":16,"syncStatus":37,"lastSyncTime":38,"discoverSource":39},7724,"solidus","solidusio\u002Fsolidus","solidusio","🛒 Solidus, the open-source eCommerce framework for industry trailblazers.","https:\u002F\u002Fsolidus.io",null,"Ruby",5306,1389,113,75,0,3,4,11,9,40.43,"Other",false,"main",true,[27,28,29,30,31,32,5,33],"ecommerce","ecommerce-framework","ecommerce-platform","hacktoberfest","rails","ruby","storefront","2026-06-12 02:01:43","\u003Cimg width=\"250\" src=\".\u002Flogo.svg\" alt=\"Solidus logo\">\n\n# Solidus\n\n[![Test](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus\u002Factions\u002Fworkflows\u002Ftest.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus\u002Factions\u002Fworkflows\u002Ftest.yml)\n[![codecov](https:\u002F\u002Fcodecov.io\u002Fgh\u002Fsolidusio\u002Fsolidus\u002Fbranch\u002Fmain\u002Fgraph\u002Fbadge.svg)](https:\u002F\u002Fcodecov.io\u002Fgh\u002Fsolidusio\u002Fsolidus\u002Fbranch\u002Fmain)\n[![Gem](https:\u002F\u002Fimg.shields.io\u002Fgem\u002Fv\u002Fsolidus.svg)](https:\u002F\u002Frubygems.org\u002Fgems\u002Fsolidus)\n[![License](http:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-BSD-blue.svg)](LICENSE.md)\n\n[![Supporters on Open Collective](https:\u002F\u002Fopencollective.com\u002Fsolidus\u002Ftiers\u002Fsupporter\u002Fbadge.svg?label=Supporters&color=brightgree)](https:\u002F\u002Fopencollective.com\u002Fsolidus)\n[![Bronze Partners on Open Collective](https:\u002F\u002Fopencollective.com\u002Fsolidus\u002Ftiers\u002Fbronze\u002Fbadge.svg?label=Bronze Partners&color=brightgree)](https:\u002F\u002Fopencollective.com\u002Fsolidus)\n[![Silver Partners on Open Collective](https:\u002F\u002Fopencollective.com\u002Fsolidus\u002Ftiers\u002Fsilver\u002Fbadge.svg?label=Silver Partners&color=brightgree)](https:\u002F\u002Fopencollective.com\u002Fsolidus)\n[![Gold Partners on Open Collective](https:\u002F\u002Fopencollective.com\u002Fsolidus\u002Ftiers\u002Fgold\u002Fbadge.svg?label=Gold Partners&color=brightgree)](https:\u002F\u002Fopencollective.com\u002Fsolidus)\n[![Open Source Helpers](https:\u002F\u002Fwww.codetriage.com\u002Fsolidusio\u002Fsolidus\u002Fbadges\u002Fusers.svg)](https:\u002F\u002Fwww.codetriage.com\u002Fsolidusio\u002Fsolidus)\n[![Slack](https:\u002F\u002Fshields.io\u002Fbadge\u002Fslack-start_chatting-blue?logo=slack)](http:\u002F\u002Fslack.solidus.io)\n\n**A free, open-source e-commerce platform that gives you complete control over your store.**\n\n- **Visit our website**: [https:\u002F\u002Fsolidus.io\u002F](https:\u002F\u002Fsolidus.io\u002F)\n- **Read our Community Guidelines**: [https:\u002F\u002Fguides.solidus.io\u002Fpolicies\u002Fcommunity-guidelines\u002F](https:\u002F\u002Fguides.solidus.io\u002Fpolicies\u002Fcommunity-guidelines\u002F)\n- **View the project roadmap**: [https:\u002F\u002Fgithub.com\u002Forgs\u002Fsolidusio\u002Fprojects\u002F7](https:\u002F\u002Fgithub.com\u002Forgs\u002Fsolidusio\u002Fprojects\u002F7)\n- **Read our guides**: [https:\u002F\u002Fguides.solidus.io\u002F](https:\u002F\u002Fguides.solidus.io\u002F)\n- **Join our Slack**: [http:\u002F\u002Fslack.solidus.io\u002F](http:\u002F\u002Fslack.solidus.io\u002F)\n- **Solidus Security**: [mailing list](https:\u002F\u002Fgroups.google.com\u002Fforum\u002F#!forum\u002Fsolidus-security)\n\n## Table of Contents\n- [Supporting Solidus](#supporting-solidus)\n- [Summary](#summary)\n- [Demo](#demo)\n- [Getting Started](#getting-started)\n- [Installation Options](#installation-options)\n- [Performance](#performance)\n- [Developing Solidus](#developing-solidus)\n- [Contributing](#contributing)\n\n## Supporting Solidus\nAs a community-driven project, Solidus relies on funds and time donated by developers and stakeholders who use Solidus for their businesses. If you'd like to help Solidus keep growing, please consider:\n\n- [Become a backer or sponsor on Open Collective](https:\u002F\u002Fopencollective.com\u002Fsolidus).\n- [Contribute to the project](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002F.github\u002Fblob\u002Fmain\u002FCONTRIBUTING.md).\n\n### Main Contributor & Director\nAt present, Nebulab is the main code contributor and director of Solidus, providing technical guidance and coordinating community efforts and activities.\n\n[![Nebulab](https:\u002F\u002Fraw.githubusercontent.com\u002Fsolidusio\u002Fbrand\u002Fmaster\u002Fpartners\u002FNebulab\u002Flogo-dark-light.svg)](https:\u002F\u002Fnebulab.com\u002F)\n\n### Ambassadors\nSupport this project by becoming a Solidus Ambassador. Your logo will show up here with a link to your website. [Become an Ambassador](https:\u002F\u002Fopencollective.com\u002Fsolidus).\n\n[![Super Good Software](https:\u002F\u002Fraw.githubusercontent.com\u002Fsolidusio\u002Fbrand\u002Fmaster\u002Fpartners\u002FSuperGood\u002Flogo-dark-light.png)](https:\u002F\u002Fsupergood.software\u002F)\n\n---\n\n## Summary\n\nSolidus is a complete open source e-commerce solution built with Ruby on Rails.\nIt is a fork of [Spree](https:\u002F\u002Fspreecommerce.org).\n\nSee the [Solidus class documentation](http:\u002F\u002Fdocs.solidus.io) and the [Solidus\nGuides](https:\u002F\u002Fguides.solidus.io) for information about the functionality that\nSolidus provides.\n\nSolidus consists of several gems. When you require the `solidus` gem in your\n`Gemfile`, Bundler will install all of the following gems:\n\n- [`solidus_api`](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus\u002Ftree\u002Fmaster\u002Fapi) (RESTful API)\n- [`solidus_backend`](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus\u002Ftree\u002Fmaster\u002Fbackend) (Admin area)\n- [`solidus_core`](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus\u002Ftree\u002Fmaster\u002Fcore) (Essential models, mailers, and classes)\n- [`solidus_sample`](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus\u002Ftree\u002Fmaster\u002Fsample) (Sample data)\n\nAll of the gems are designed to work together to provide a fully functional\ne-commerce platform. However, you may only want to use the\n[`solidus_core`](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus\u002Ftree\u002Fmaster\u002Fcore) gem\ncombine it with your own custom frontend, admin interface, and API.\n\n## Demo\n\nYou can try the live Solidus demo [here.](http:\u002F\u002Fdemo.solidus.io\u002F) The admin section can be accessed [here.](http:\u002F\u002Fdemo.solidus.io\u002Fadmin)\n\n## Getting started\n\nBegin by making sure you have\n[Imagemagick](http:\u002F\u002Fimagemagick.org\u002Fscript\u002Fdownload.php) installed, which is\nrequired for Paperclip. (You can install it using [Homebrew](https:\u002F\u002Fbrew.sh) if\nyou're on a Mac.)\n\nTo add Solidus, begin with a newly created Rails application with its database.\n\n```bash\nrails new my_store\n```\n\n> [!CAUTION]\n> Due to [a bug in `sprockets-rails`](https:\u002F\u002Fgithub.com\u002Frails\u002Fsprockets-rails\u002Fpull\u002F546) we need to manually add the sprockets manifest into the generated rails app **before** running any rails commands inside the rails app folder.\n\n```bash\nmkdir -p my_store\u002Fapp\u002Fassets\u002Fconfig\ncat \u003C\u003CMANIFEST > my_store\u002Fapp\u002Fassets\u002Fconfig\u002Fmanifest.js\n\u002F\u002F= link_tree ..\u002Fimages\n\u002F\u002F= link_directory ..\u002Fjavascripts .js\n\u002F\u002F= link_directory ..\u002Fstylesheets .css\nMANIFEST\n```\n\n### Installing Solidus\n\nIn your application's root folder run:\n\n```bash\nbundle add solidus\nbin\u002Frails g solidus:install\n```\n\n> [!NOTE]\n> Please make sure to generate the sprockets manifest before running the `solidus:install` generator.\n\nAnd follow the prompt's instructions.\n### Accessing Solidus Store\n\nStart the Rails server with the command:\n\n```bash\nbin\u002Frails s\n```\n\nThe storefront will be accessible at\n[http:\u002F\u002Flocalhost:3000\u002F](http:\u002F\u002Flocalhost:3000\u002F) and the admin can be found at\n[http:\u002F\u002Flocalhost:3000\u002Fadmin\u002F](http:\u002F\u002Flocalhost:3000\u002Fadmin\u002F).\n\nFor information on how to customize your store, check out the [customization guides](https:\u002F\u002Fguides.solidus.io\u002Fcustomization\u002Fcustomizing-your-storefront).\n\n### Default Username\u002FPassword\n\nAs part of running the above installation steps, you will be asked to set an admin email\u002Fpassword combination. The default values are `admin@example.com` and `test123`, respectively.\n\n### Questions?\n\nThe best way to ask questions is to [join the Solidus Slack](http:\u002F\u002Fslack.solidus.io\u002F) and join the [#support channel](https:\u002F\u002Fsolidusio.slack.com\u002Fmessages\u002Fsupport\u002Fdetails\u002F).\n\n## Installation options\n\nInstead of a stable build, if you want to use the bleeding edge version of\nSolidus, use this line:\n\n```ruby\ngem 'solidus', github: 'solidusio\u002Fsolidus'\n```\n\n**Note: The master branch is not guaranteed to ever be in a fully functioning\nstate. It is too risky to use this branch in production.**\n\nBy default, the installation generator (`solidus:install`) will run\nmigrations as well as adding seed and sample data. This can be disabled using\n\n```bash\nbin\u002Frails g solidus:install --migrate=false --sample=false --seed=false\n```\n\nYou can always perform any of these steps later by using these commands.\n\n```bash\nbin\u002Frails railties:install:migrations\nbin\u002Frails db:migrate\nbin\u002Frails db:seed\nbin\u002Frails spree_sample:load\n```\n\nThere are also options and rake tasks provided by\n[solidus\\_auth\\_devise](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus_auth_devise).\n\n## Performance\n\nYou may notice that your Solidus store runs slowly in development mode. This\ncan be because in development each CSS and JavaScript is loaded as a separate\ninclude. This can be disabled by adding the following to\n`config\u002Fenvironments\u002Fdevelopment.rb`.\n\n```ruby\nconfig.assets.debug = false\n```\n\n### Turbolinks\n\nTo gain some extra speed you may enable Turbolinks inside of Solidus admin.\n\nAdd `gem 'turbolinks', '~> 5.0.0'` into your `Gemfile` (if not already present)\nand change `vendor\u002Fassets\u002Fjavascripts\u002Fspree\u002Fbackend\u002Fall.js` as follows:\n\n```js\n\u002F\u002F= require turbolinks\n\u002F\u002F\n\u002F\u002F ... current file content\n\u002F\u002F\n\u002F\u002F= require spree\u002Fbackend\u002Fturbolinks-integration.js\n```\n\n**CAUTION** Please be aware that Turbolinks can break extensions\nand\u002For customizations to the Solidus admin. Use at your own risk.\n\n## Developing Solidus\n\n* Clone the Git repo\n\n  ```bash\n  git clone git:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus.git\n  cd solidus\n  ```\n\n### Without Docker\n\n* Install the gem dependencies\n\n  ```bash\n  bin\u002Fsetup\n  ```\n\n  _Note_: If you're using PostgreSQL or MySQL, you'll need to install those gems through the DB environment variable.\n\n  ```bash\n  # PostgreSQL\n  export DB=postgresql\n  bin\u002Fsetup\n\n  # MySQL\n  export DB=mysql\n  bin\u002Fsetup\n  ```\n\n### With Docker\n\n```bash\ndocker-compose up -d\n```\n\nWait for all the gems to be installed (progress can be checked through `docker-compose logs -f app`).\n\nYou can provide the ruby version you want your image to use:\n\n```bash\ndocker-compose build --build-arg RUBY_VERSION=3.0 app\ndocker-compose up -d\n```\n\nThe rails version can be customized at runtime through the `RAILS_VERSION` environment variable:\n\n```bash\nRAILS_VERSION='~> 5.0' docker-compose up -d\n```\n\nRunning tests:\n\n```bash\n# sqlite\ndocker-compose exec app bin\u002Frspec\n# postgres\ndocker-compose exec app env DB=postgres bin\u002Frspec\n# mysql\ndocker-compose exec app env DB=mysql bin\u002Frspec\n```\n\nAccessing the databases:\n\n```bash\n# sqlite\ndocker-compose exec app sqlite3 \u002Fpath\u002Fto\u002Fdb\n# postgres\ndocker-compose exec app env PGPASSWORD=password psql -U root -h postgres\n# mysql\ndocker-compose exec app mysql -u root -h mysql -ppassword\n```\n\nIn order to be able to access the [sandbox application](#sandbox), just make\nsure to provide the appropriate `--binding` option to `rails server`. By\ndefault, port `3000` is exposed, but you can change it through `SANDBOX_PORT`\nenvironment variable:\n\n```bash\nSANDBOX_PORT=4000 docker-compose up -d\ndocker-compose exec app bin\u002Fsandbox\ndocker-compose exec app bin\u002Frails server --binding 0.0.0.0 --port 4000\n```\n\n### Sandbox\n\nSolidus is meant to be run within the context of Rails application. You can\neasily create a sandbox application inside of your cloned source directory for\ntesting purposes.\n\nThis sandbox includes solidus\\_auth\\_devise and generates with seed and sample\ndata already loaded.\n\n* Create the sandbox application\n\n  ```bash\n  bin\u002Fsandbox\n  ```\n\n  You can create a sandbox with PostgreSQL or MySQL by setting the DB environment variable.\n\n  ```bash\n  # PostgreSQL\n  export DB=postgresql\n  bin\u002Fsandbox\n\n  # MySQL\n  export DB=mysql\n  bin\u002Fsandbox\n  ```\n\n  Depending on your local environment, it may be necessary for you to set environment variables for your RDBMS, namely:\n    - `DB_HOST`\n    - `DB_USER`\n    - `DB_PASSWORD`\n\n  If you need to create a Rails 5.2 application for your sandbox, for example\n  if you are still using Ruby 2.4 which is not supported by Rails 6, you can\n  use the `RAILS_VERSION` environment variable.\n\n  ```bash\n    export RAILS_VERSION='~> 5.2.0'\n    bin\u002Fsetup\n    bin\u002Fsandbox\n  ```\n\n* You can start the Rails server and other services from either the Solidus folder or the\nsandbox one by running the command:\n\n  ```bash\n  bin\u002Fdev\n  ```\n\nPlease note: if you run `bin\u002Frails server` or similar commands, only the Rails server will\nstart. This might cause the error `couldn't find file 'solidus_admin\u002Ftailwind.css'` when you\ntry to load admin pages.\n\n### Tests\n\nSolidus uses [RSpec](http:\u002F\u002Frspec.info) for tests. Refer to its documentation for\nmore information about the testing library.\n\n#### CircleCI\n\nWe use CircleCI to run the tests for Solidus as well as all incoming pull\nrequests. All pull requests must pass to be merged.\n\nYou can see the build statuses at\n[https:\u002F\u002Fcircleci.com\u002Fgh\u002Fsolidusio\u002Fsolidus](https:\u002F\u002Fcircleci.com\u002Fgh\u002Fsolidusio\u002Fsolidus).\n\n#### Run all tests\n\n[ChromeDriver](https:\u002F\u002Fchromedriver.chromium.org\u002Fdownloads) is required to run\nthe backend test suites.\n\nTo execute all of the test specs, run the `bin\u002Fbuild` script at the root of the Solidus project:\n\n```bash\ncreateuser --superuser --echo postgres # only the first time\nbin\u002Fbuild\n```\n\nThe `bin\u002Fbuild` script runs using PostgreSQL by default, but it can be overridden by setting the DB environment variable to `DB=sqlite` or `DB=mysql`. For example:\n\n```bash\nenv DB=mysql bin\u002Fbuild\n```\n\nIf the command fails with MySQL related errors you can try creating a user with this command:\n\n```bash\n# Creates a user with the same name as the current user and no restrictions.\nmysql --user=\"root\" --execute=\"CREATE USER '$USER'@'localhost'; GRANT ALL PRIVILEGES ON * . * TO '$USER'@'localhost';\"\n```\n\n#### Run an individual test suite\n\nEach gem contains its own series of tests. To run the tests for the core project:\n\n```bash\ncd core\nbundle exec rspec\n```\n\nBy default, `rspec` runs the tests for SQLite 3. If you would like to run specs\nagainst another database you may specify the database in the command:\n\n```bash\nenv DB=postgresql bundle exec rspec\n```\n\n#### Code coverage reports\n\nIf you want to run the [SimpleCov](https:\u002F\u002Fgithub.com\u002Fcolszowka\u002Fsimplecov) code\ncoverage report:\n\n```bash\nCOVERAGE=true bundle exec rspec\n```\n\n### Extensions\n\nIn addition to core functionality provided in Solidus, there are a number of\nways to add features to your store that are not (or not yet) part of the core\nproject.\n\nA list can be found at [extensions.solidus.io](http:\u002F\u002Fextensions.solidus.io\u002F).\n\nIf you want to write an extension for Solidus, you can use the\n[solidus_dev_support](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002Fsolidus_dev_support.git) gem.\n\n## Contributing\n\nSolidus is an open source project and we encourage contributions. Please read\n[CONTRIBUTING.md](https:\u002F\u002Fgithub.com\u002Fsolidusio\u002F.github\u002Fblob\u002Fmain\u002FCONTRIBUTING.md) before contributing.\n","Solidus 是一个开源的电子商务框架，旨在为行业先锋提供全面的在线商店解决方案。它基于 Ruby on Rails 构建，拥有灵活的架构设计，支持高度定制化需求，包括商品管理、订单处理、支付集成等核心电商功能。此外，Solidus 还提供了丰富的扩展插件生态系统，允许开发者根据具体业务场景快速添加新特性。适合于需要强大自定义能力和良好扩展性的中大型电商平台使用，无论是初创企业还是成熟品牌都能从中受益。",2,"2026-06-11 03:14:01","top_language"]