{"id":28172846,"url":"https://github.com/awcodify/arsxy-theme","last_synced_at":"2026-02-15T03:31:59.155Z","repository":{"id":293100554,"uuid":"982939400","full_name":"awcodify/arsxy-theme","owner":"awcodify","description":"Jekyll Theme","archived":false,"fork":false,"pushed_at":"2025-11-13T07:40:15.000Z","size":13949,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-13T09:16:45.921Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://awcodify.github.io/arsxy-theme/","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/awcodify.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-13T16:19:56.000Z","updated_at":"2025-11-13T07:40:19.000Z","dependencies_parsed_at":"2025-05-28T10:27:13.252Z","dependency_job_id":"381403ed-d3cd-4022-8233-e7b8fa6f1996","html_url":"https://github.com/awcodify/arsxy-theme","commit_stats":null,"previous_names":["awcodify/sysctl-theme","awcodify/arsxy-theme"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/awcodify/arsxy-theme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awcodify%2Farsxy-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awcodify%2Farsxy-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awcodify%2Farsxy-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awcodify%2Farsxy-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awcodify","download_url":"https://codeload.github.com/awcodify/arsxy-theme/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awcodify%2Farsxy-theme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29466929,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T01:01:38.065Z","status":"online","status_checked_at":"2026-02-15T02:00:07.449Z","response_time":118,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-05-15T20:11:12.951Z","updated_at":"2026-02-15T03:31:59.149Z","avatar_url":"https://github.com/awcodify.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Arsxy Theme for Jekyll\n\nA clean, modern Jekyll theme optimized for technical blogs and documentation sites. This theme prioritizes readability, performance, and responsive design.\n\n\u003e **Current Status**: This theme is currently in beta (v1.0.0-beta). While it's functional and feature-rich, it may receive some refinements before the final stable release.\n\n\u003e **Built with AI**: This theme was developed with the assistance of GitHub Copilot and Claude 3.7 Sonnet.\n\n![Arsxy Theme Screenshot](assets/images/ss-arsxy-theme.webp)\n\n## Demo\n\n- **Theme Demo**: [https://awcodify.github.io/arsxy-theme/](https://awcodify.github.io/arsxy-theme/)\n- **Real-world Implementation**: [https://sysctl.id](https://sysctl.id)\n\n## Features\n\n- **Clean \u0026 Modern Design** - Minimal, distraction-free reading experience\n- **Responsive Layout** - Optimized for all devices from mobile to desktop\n- **Dark Mode Support** - Built-in dark mode toggle option with logo treatment options\n- **Comment System** - Support for Giscus (GitHub Discussions) comments\n- **Code Highlighting** - Beautiful syntax highlighting for technical content\n- **Table of Contents** - Automatically generated for longer articles\n- **SEO Optimized** - Built-in support for meta tags and structured data\n- **Performance Focused** - Fast loading times with minimal dependencies\n- **Reading Time** - Automatic reading time estimation for each post\n- **Featured Posts** - Highlight your best content on the homepage\n- **Categories \u0026 Tags** - Organized content structure\n- **Seamless Featured Images** - Dynamically creates a blurred background from the post's featured image for a beautiful, blended effect.\n\n## Installation\n\n### As a remote theme (recommended)\n\nAdd this line to your Jekyll site's `_config.yml`:\n\n```yaml\nremote_theme: awcodify/arsxy-theme\n```\n\nAnd install the necessary plugins:\n\n```ruby\n# In your Gemfile\ngroup :jekyll_plugins do\n  gem \"jekyll-remote-theme\"\n  gem \"jekyll-feed\"\n  gem \"jekyll-seo-tag\"\n  gem \"jekyll-sitemap\"\n  gem \"jekyll-paginate\"\nend\n```\n\n### As a regular theme\n\nAdd this line to your Jekyll site's `Gemfile`:\n\n```ruby\ngem \"arsxy-theme\"\n```\n\nAnd add this line to your Jekyll site's `_config.yml`:\n\n```yaml\ntheme: arsxy-theme\n```\n\nAnd then execute:\n\n```bash\n$ bundle install\n```\n\n## Usage\n\n### Configuration\n\nHere's a sample configuration with commonly used options:\n\n```yaml\n# Site settings\nname: Your Site Name\ntitle: Your Site Title\ndescription: \u003e-\n  Your site description for SEO and social sharing.\nbaseurl: \"/\"\nurl: \"https://yourdomain.com\"\n\n# Theme settings\nremote_theme: awcodify/arsxy-theme\n# - OR if installing as a gem -\n# theme: arsxy-theme\n\n# Navigation menu\nnavigation:\n  - title: Home\n    url: /\n  - title: About\n    url: /about\n  - title: Articles\n    url: /articles\n  - title: Tags\n    url: /tags\n  - title: Contact\n    url: /contact\n\n# Social links\nsocial:\n  github: yourusername\n  twitter: yourusername\n  linkedin: yourusername\n  email: your.email@example.com\n\n# Plugin settings\nplugins:\n  - jekyll-feed\n  - jekyll-seo-tag\n  - jekyll-sitemap\n  - jekyll-paginate\n```\n\n### Creating Posts\n\nCreate a new file in the `_posts` directory with the format `YYYY-MM-DD-title.md`:\n\n```markdown\n---\nlayout: post\ntitle: \"Your Post Title\"\ndescription: \"A brief description of your post for SEO and previews.\"\ncategories: Category\ntags: tag1 tag2 tag3\nimage: path/to/featured-image.jpg\n---\n\nYour content goes here...\n```\n\n### Featured Images\n\nFor best results, use featured images in your posts. The recommended image size is 1200×630 pixels for optimal display on both the homepage and social media shares.\n\n### Table of Contents\n\nThe table of contents is automatically generated for posts. If you want to disable it for a specific post, add `toc: false` to the front matter.\n\n## Customization\n\n### Colors and Typography\n\nYou can override the default colors and typography by creating a `_sass/_custom.scss` file in your site and importing it in your `assets/css/main.scss`.\n\n## Important Notes\n\n- This theme requires Jekyll 3.10 or compatible versions\n- For best performance, optimize your images before adding them to your site\n- The theme includes built-in dark mode that respects user system preferences\n\n## License\n\nThis theme is available as open source under the terms of the [MIT License](LICENSE).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/awcodify/arsxy-theme.\n\nWe appreciate your contributions to make Arsxy Theme better! Please check out our [Contributing Guidelines](CONTRIBUTING.md) for details on:\n\n- How to submit pull requests\n- Coding standards\n- Development process\n\nWhen submitting pull requests, please use the appropriate PR template to help maintainers understand and review your changes efficiently.\n\n## Homepage Redesign (v1.0+)\n\nThe Arsxy Theme homepage has been completely redesigned for a denser, more modern, and highly customizable experience:\n\n- **Animated Gradient Hero**: CSS-only animated gradient background with headline, subtitle, and call-to-action buttons.\n- **Featured Posts**: One full-width featured article at the top, followed by a grid of two featured articles below, each with a prominent image and badge.\n- **Latest Articles**: Dense, full-width article list with right-aligned thumbnails, minimal padding, and semantic HTML for SEO.\n- **Modern Sidebar**: Categories, tags, and about widgets in a visually distinct sidebar.\n- **Dark Mode**: All homepage elements fully support dark mode, with improved text and card contrast.\n- **Performance**: No JavaScript required for layout or animation; all effects are pure CSS.\n\n### Customizing the Homepage\n\n- **Featured Posts**: Mark posts as `featured: true` in their front matter to display them in the featured section.\n- **Hero Section**: Configure the hero title, subtitle, and buttons in `_config.yml` under `homepage.hero`.\n- **Sidebar**: Sidebar widgets (categories, tags, about) are controlled via includes and can be customized or reordered.\n- **Colors \u0026 Variables**: All colors, backgrounds, and card styles are controlled via CSS variables (see [CSS Variables Reference](docs/css-variables.md)).\n- **Responsive**: The homepage layout adapts to all screen sizes, with grid and flexbox breakpoints.\n\nSee the [layouts](docs/layouts.md), [customization](docs/customization.md), and [dark mode](docs/dark-mode.md) docs for more details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawcodify%2Farsxy-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawcodify%2Farsxy-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawcodify%2Farsxy-theme/lists"}