{"id":28089541,"url":"https://github.com/ravorona/sage","last_synced_at":"2025-05-13T12:59:48.974Z","repository":{"id":56392689,"uuid":"287245287","full_name":"ravorona/sage","owner":"ravorona","description":"Wordpress theme, based on Sage starter theme","archived":false,"fork":false,"pushed_at":"2024-04-13T21:49:09.000Z","size":1523,"stargazers_count":45,"open_issues_count":2,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-19T12:14:24.424Z","etag":null,"topics":["sage","sass","theme","typescript","wordpress"],"latest_commit_sha":null,"homepage":"","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ravorona.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2020-08-13T10:09:10.000Z","updated_at":"2025-01-30T22:39:31.000Z","dependencies_parsed_at":"2024-11-24T12:19:08.893Z","dependency_job_id":null,"html_url":"https://github.com/ravorona/sage","commit_stats":{"total_commits":153,"total_committers":1,"mean_commits":153.0,"dds":0.0,"last_synced_commit":"9d8776575f9e58dd779c1935fcd94631e3f3f479"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravorona%2Fsage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravorona%2Fsage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravorona%2Fsage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravorona%2Fsage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ravorona","download_url":"https://codeload.github.com/ravorona/sage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253948408,"owners_count":21988953,"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":["sage","sass","theme","typescript","wordpress"],"created_at":"2025-05-13T12:59:48.418Z","updated_at":"2025-05-13T12:59:48.954Z","avatar_url":"https://github.com/ravorona.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Development](https://github.com/ravorona/sage/actions/workflows/develop.yml/badge.svg) ![Release](https://github.com/ravorona/sage/actions/workflows/publish.yml/badge.svg)\n\n# 🧩 Wordpress Starter Theme\n\n- Based on [Sage](https://roots.io/sage/) version [10](https://github.com/roots/sage/)\n- Using [Vite](https://vitejs.dev)\n\n## Requirements\n\n- [Acorn](https://roots.io/acorn/docs/installation/) v3\n- [PHP](https://secure.php.net/manual/en/install.php) \u003e= 8.0 (\n  with [`php-mbstring`](https://secure.php.net/manual/en/book.mbstring.php) enabled)\n- [Composer](https://getcomposer.org/download/)\n- [Vite](https://vitejs.dev) \u003e= 3.1.0\n- [Node.js](http://nodejs.org/) \u003e= 16.0.0\n- [Yarn](https://yarnpkg.com/en/docs/install)\n\n## Theme installation\n\n- **Make sure that you have [Acorn installed](https://roots.io/acorn/docs/installation/)**\n- Install Sage using Composer from your WordPress themes directory (replace `your-theme-name` below with the name of\n  your theme):\n\n```shell\n# @ app/themes/ or wp-content/themes/\n$ composer create-project ravorona/sage your-theme-name\n```\n\nTo install the latest development version of Sage, add `dev-develop` to the end of the command:\n\n```shell\n$ composer create-project ravorona/sage your-theme-name dev-develop\n```\n\n## Theme structure\n\n```sh\nthemes/your-theme-name/   # → Root of your Sage based theme\n├── app/                  # → Theme PHP\n│   ├── Providers/        # → Service providers\n│   ├── View/             # → View models\n│   ├── filters.php       # → Theme filters\n│   ├── helpers.php       # → Global helpers\n│   ├── medias.php        # → Medias helper\n│   └── setup.php         # → Theme setup\n├── composer.json         # → Autoloading for `app/` files\n├── public/               # → Built theme assets (never edit)\n├── functions.php         # → Theme bootloader\n├── index.php             # → Theme template wrapper\n├── node_modules/         # → Node.js packages (never edit)\n├── package.json          # → Node.js dependencies and scripts\n├── resources/            # → Theme assets and templates\n│   ├── fonts/            # → Theme fonts\n│   ├── images/           # → Theme images\n│   ├── scripts/          # → Theme javascript\n│   ├── styles/           # → Theme stylesheets\n│   ├── svg/              # → Theme svgs\n│   └── views/            # → Theme templates\n│       ├── components/   # → Component templates\n│       ├── forms/        # → Form templates\n│       ├── layouts/      # → Base templates\n│       ├── partials/     # → Partial templates\n        └── sections/     # → Section templates\n├── screenshot.png        # → Theme screenshot for WP admin\n├── style.css             # → Theme meta information\n├── vendor/               # → Composer packages (never edit)\n└── vite.config.ts        # → Vite configuration\n```\n\n## Theme development\n\n- Run `yarn` from the theme directory to install dependencies\n- Update `vite.config.ts` for bundler fine tuning\n\n### Build commands\n\n- `yarn dev` — Start dev server and hot module replacement\n- `yarn build` — Compile assets\n- `yarn lint` — Lint stylesheets \u0026 javascripts\n- `yarn lint:css` — Lint stylesheets\n- `yarn lint:js` — Lint javascripts\n\n### Hot Module Replacement\n\n#### Project Side\n\nAdd the following variables in your project `.env`\n\n```sh\n# Endpoint where the bundler serve your assets\nHMR_ENTRYPOINT=http://localhost:5173\n```\n\n#### Theme side\n\nFor advanced dev server configuration, copy `.env.example` according\nto [Vite naming convention and loading order](https://vitejs.dev/guide/env-and-mode.html#env-files) and update variables\n\n#### FYI\n\nRunning HMR Mode remove the `public/manifest.json` file, so do not forget to re-run the assets compilation\nwith `yarn build` if needed.\n\n## Documentation\n\n- [Sage documentation](https://roots.io/sage/docs/)\n- [Controller documentation](https://github.com/soberwp/controller#usage)\n- [Vite](https://vitejs.dev/guide/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fravorona%2Fsage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fravorona%2Fsage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fravorona%2Fsage/lists"}