akvadrako / site-xyz

Wall to Wall Site

• netlify

TODO

• tailwind
• sitemap
• catch errors globally?
• monitoring
• analytics
• comments?

TOC

static

• admin
  • config.yml -- CMS config
  • index.html -- CMS entrypoint
• favicon.png
• uploads
  • CMS-editable images

src

• routes
  • *.md -- CMS-editable mdsvex files
• comp
  • *.svelte -- components
• layouts
  • default.svelte -- default template

root

• /netlify.toml -- config

Usage

Prereqs:

• git LFS
• npm

Develop locally:

npm install
npx netlify-cms-proxy-server
npm run dev -- --open
npm run build
npm run preview

Deploy:

• git commit

Technical Intro

Style

• tailwind - https://tailwindcss.com/docs/guides/sveltekit
• windicss
  • https://windicss.org/guide/configuration.html
  • npx windicss-analysis
• flowbite - https://flowbite.com/docs/getting-started/introduction/

Mdsvex

• https://mdsvex.com/docs

• links - https://github.com/landakram/remark-wiki-link

• embedded js:

  <script>
  <script context="module">

• https://github.com/jxnblk/vim-mdx-js

• https://github.com/rehypejs/rehype/blob/main/doc/plugins.md

• https://github.com/remarkjs/remark/blob/main/doc/plugins.md

i18n

• sveltejs/kit#553

Related

• https://github.com/rodneylab/sveltekit-blog-mdx
• Based on sveltekit-netlify-cms.

Netlify

• forms: https://docs.netlify.com/site-deploys/post-processing/form-detection/
• large media: https://app.netlify.com/sites/lucid-hodgkin-cc7294/large-media

One-time Setup

Docs

• LFS setup

Netlify

1. Go to Settings > Identity, and select Enable Identity service.

• Under Registration preferences, Invite-Only
• External Providers -> Github -> One Click Login

2. Services > Git Gateway -> Enable Git Gateway.

In repo

netlify link
netlify lm:setup
git lfs track "static/media/**"
git lfs ls-files

3. Alternative to Git Gateway

Add Github to Access

• https://docs.netlify.com/visitor-access/oauth-provider-tokens/