{"id":15511117,"url":"https://github.com/MaybeThisIsRu/smix-eleventy-starter","last_synced_at":"2025-10-12T08:30:56.876Z","repository":{"id":38425202,"uuid":"255096231","full_name":"MaybeThisIsRu/smix-eleventy-starter","owner":"MaybeThisIsRu","description":"A standards-respecting starter kit for Eleventy. Go Indie.","archived":false,"fork":false,"pushed_at":"2023-01-09T15:28:13.000Z","size":6751,"stargazers_count":117,"open_issues_count":8,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-23T02:13:42.460Z","etag":null,"topics":["11ty","eleventy","indieweb","indieweb-starter","jamstack","starter-kit","static-site-boilerplate"],"latest_commit_sha":null,"homepage":"https://smix.netlify.app/","language":"CSS","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/MaybeThisIsRu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-12T14:09:58.000Z","updated_at":"2024-10-03T18:57:48.000Z","dependencies_parsed_at":"2023-02-08T12:31:48.273Z","dependency_job_id":null,"html_url":"https://github.com/MaybeThisIsRu/smix-eleventy-starter","commit_stats":null,"previous_names":["hirusi/smix-eleventy-starter"],"tags_count":11,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaybeThisIsRu%2Fsmix-eleventy-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaybeThisIsRu%2Fsmix-eleventy-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaybeThisIsRu%2Fsmix-eleventy-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaybeThisIsRu%2Fsmix-eleventy-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MaybeThisIsRu","download_url":"https://codeload.github.com/MaybeThisIsRu/smix-eleventy-starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236188257,"owners_count":19109383,"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":["11ty","eleventy","indieweb","indieweb-starter","jamstack","starter-kit","static-site-boilerplate"],"created_at":"2024-10-02T09:52:51.205Z","updated_at":"2025-10-12T08:30:56.475Z","avatar_url":"https://github.com/MaybeThisIsRu.png","language":"CSS","funding_links":[],"categories":["CSS"],"sub_categories":[],"readme":"# 🌻 Smix\n\nA standards-respecting starter kit for Eleventy. Go Indie.\n\n⚠️ This project is now considered more-or-less complete for the author's needs. Any further enhancements will require a pull request to come from the community.\n\n## Reading.\n\nFor nice text, there's [Typeset](https://www.npmjs.com/package/typeset). While it adds to the build time, it makes for a more polished reading experience.\n\nIt seems [people do rely on RSS feeds](https://twitter.com/mxbck/status/1490698469312536578) even in 2022! Cheers to that; there's an Atom feed that is standards-compliant. It understands the published and updated datetime stamps on posts, and uses the RFC822 date format.\n\nDark mode is included out of the box using a custom media query. (More in future-ready section below).\n\nDate filters such as for friendly dates (10 March 2020) and machine-parseable dates (ISO8601) are available to use via filters.\n\n## Discoverability/SEO.\n\nMeta tags for social networks (Open Graph as well as Twitter). This allows for a nice card display when you (or someone else) shares a link to your post or site. Support for `content-description` meta tag -- this helps decide what text to show for a page/post when shared on social media, as well as in search engines.\n\nSitemap with `changeFrequency` -- so bots only come back when they need to. (please also see [issue #7](https://github.com/hirusi/smix-eleventy-starter/issues/7)). `robots.txt` is a cherry on the top -- I would also recommend using it to [hide your personal picture](https://rusingh.com/block-images-appearing-in-search/) if so desired.\n\n\n## Writing\n\nWrite in Markdown, much loved among developers. If you don't already know it, it's [easy to get started](https://commonmark.org/help/tutorial/). You can also use separate apps and then copy-paste your content into a new file. This allows for focusing on content first, before messing with any technicals. I recommend [Bear](https://bear.app/).\n\n### Linking to pages or posts.\n\n`postUrl` shortcode similar to Jekyll's `post_url` and `link` liquid tags:\n\n```liquid\n{% postUrl collections.primary 'on-burnout' %}\n```\n\n### Code blocks.\n\nCode blocks are made possible via [an Eleventy plugin](https://www.11ty.dev/docs/plugins/syntaxhighlight/). Many [Prism](https://prismjs.com/) themes are [available to use](https://github.com/PrismJS/prism-themes/tree/master/themes).\n\n## IndieWeb\n\nFor those pushing [#IndieWeb](https://www.smashingmagazine.com/2020/08/autonomy-online-indieweb/), some basic [Microformats2](https://indieweb.org/microformats2) support is included. From h-card to understand authorship, h-entry to understand a post, and h-feed to have Microformat feeds. This allows following a website in [Microsub readers](https://indieweb.org/Microsub).\n\nThe following [post-types](https://indieweb.org/posts#Types_of_Posts) are supported:\n\n- 📄 Article\n- 📔 Note\n- ↪ Reply\n- 📷 Photo\n\nA single microformats2 feeds is offered via `h-feed`. This includes articles, notes, replies (with or without context), and image(s). These post types also seamlessly work in the Atom feed.\n\n## Future-ready.\n\nThe CSS is written with upcoming CSS standards in mind. This is made possible thanks to PostCSS. Inclusions: imports, nesting, purge, minification, autoprefixer, custom properties, custom media queries (this makes a dark mode easy to build!), custom selectors, and [LCH color coding](https://lea.verou.me/2020/04/lch-colors-in-css-what-why-and-how/).\n\nJavaScript is transpiled and bundled via `esbuild`.\n\n## Accessible.\n\n[Atkinson font by The Braille Institute](https://brailleinstitute.org/freefont) is included if you wish to use it. If not, there's a sans, serif, and mono fallback to system fonts.\n\nCare is taken to have good contrast all around.\n\nShould you choose to include some animations, do make use of a custom media query for those who prefer less motion:\n\n```css\n/* Prefers reduced motion. */\n@media screen and (--rm) {\n  .fancy {\n    /* Disable animations. */\n  }\n}\n```\n\n## Under The Hood.\n\n### Handling JavaScript.\n\nES Modules are [now well supported](https://caniuse.com/es6-module) and you should move to them. In that spirit, we use [`esbuild`](https://esbuild.github.io/).\n\nIf you want to bundle a single file and that is the default `index.js` source, running `npm run dev:js` is enough.\n\nTo allow for page-specific JavaScript files, we have a convenience command to put together a new JS bundle.\n\n```sh\nnpm run dev:jsb --in=portfolio.js --out=portfolio.js\n```\n\nThis will create a JS bunlde (hence `jsb`), entering at `src/assets/js/portfolio.js` and outputting at `dist/assets/js/portfolio.js`\n\nInclude them in the required page by using the `pageJavaScript` [`block`](https://liquidjs.com/tutorials/partials-and-layouts.html#Layout-Templates-Extends):\n\n```liquid\n{% block pageJavascript %}\n\u003cscript type=\"module\" src=\"/assets/js/portfolio.js\"\u003e\n{% endblock}\n\nMy content here.\n```\n\n### Misc Features\n\n* __Prettier and editorconfig__ for consistent formatting of the codebase.\n\n## To-Do\n\n* Feed per tag (this could easily go into 10s or 100s, but you know, choice is important!)\n* Scheduled blog posts.\n* Re-do development and production docs as needed.\n\n## Built off of\n\nSites that took Smix Eleventy Starter and made something of their own:\n\n- [Add your site here]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaybeThisIsRu%2Fsmix-eleventy-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMaybeThisIsRu%2Fsmix-eleventy-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaybeThisIsRu%2Fsmix-eleventy-starter/lists"}