Go to file
matthieu42morin 918a02e6d2 project description 2024-03-20 16:14:17 +01:00
.vscode Init, Main page design choices 2023-11-06 11:02:38 +01:00
src funi error 2024-03-20 16:12:21 +01:00
static funi error 2024-03-20 16:12:21 +01:00
tests Services OVERHAUL =>> using json with schemas and validators as database 2024-03-20 16:11:46 +01:00
.dockerignore ignores add, fix 2024-03-16 03:53:01 +01:00
.eslintignore ignores add, fix 2024-03-16 03:53:01 +01:00
.eslintrc.cjs Init, Main page design choices 2023-11-06 11:02:38 +01:00
.gitignore ignores add, fix 2024-03-16 03:53:01 +01:00
.npmrc Init, Main page design choices 2023-11-06 11:02:38 +01:00
.prettierignore ignores add, fix 2024-03-16 03:53:01 +01:00
.prettierrc Init, Main page design choices 2023-11-06 11:02:38 +01:00
README.md project description 2024-03-20 16:14:17 +01:00
package.json Services OVERHAUL =>> using json with schemas and validators as database 2024-03-20 16:11:46 +01:00
playwright.config.ts Init, Main page design choices 2023-11-06 11:02:38 +01:00
postcss.config.cjs Init, Main page design choices 2023-11-06 11:02:38 +01:00
svelte.config.js Config - Adding aliases 2024-03-19 22:20:38 +01:00
tailwind.config.ts Init, Main page design choices 2023-11-06 11:02:38 +01:00
tsconfig.json paths directly in tsconfig interfere with autogenerated aliases, I added both at the same time - instead you need to rerun dev server to autogenerate again. 2024-03-19 22:31:28 +01:00
vite.config.ts sentry, hooks, CSP update 2024-03-20 16:09:11 +01:00

README.md

create-svelte

This is the repo of the website Kkosmetickysalon.cz, my mom's business, I also did the logos and branding, which are located in /static

Webapp stack

Sveltekit with advanced config

Sveltekit is simple, modern metaframework for svelte. The docs are great, love the decisions and features, don't need anything more or less for websites with moderate complexity and PWAs.

Skeleton UI library

This is perhaps the best UI library for sveltekit, their docs and their code is great

Tailwind + PostCSS + Fontawesome local

Utility css is quick to develop, easy to remember, readable little boilerplate needed. Postcss as a dependency and for conditional css. Fontawesome free for local icons as fonts.

Most importantly, SCREW CMS, use .md or json or yaml and parse them

Motivation

I have spent considerable amount of time researching and learning the bloatware that is on the internet caused by the nocode movement and enough is enough. It takes a fraction of a time, if any to understand how json works, if you know it's a way to represent and structure content, then you're set.

  • it's dead simple and you literally almost just import it
  • You don't have to host strapi or a db on a 4GB RAM server in the cloud for making a post once a month
  • Static makes better SEO

Use case

I have a $content path (./src/content), where I have ./services/ and ./posts in the former I store individual service categories (and their respective items) in json files, in the latter I have posts, where I store .md files, which are subsequently processed by MDSveX and the html outputted from MDSveX is relayed to ./sluzby/[id]. It's very DRY, there are no lockins and it's reusable on a lot of platforms. Everything has a schema (e.g. ./sluzby/schema#) or a type or a generatable template. The schema can be used with a JSON editor to help nontechies write it. The json data is then validated by ajv to match the type Service in $lib/types/service.d.ts

Features, Components and parts

A list of mostly

LibreMaps

Screw Google Maps, I knew I wanted to use OSM, maybe Mapbox, because I had experience with it, but this was a great ready made, quality solution, repo is here.

Instagram feed

CSP, custom hooks, custom headers

Securing this app with the latest security features and web technologies.

Service Worker

Why not?

Admin/DevOps Tools

A list of mostly 3rd party useful tools this project uses.

Gitea action CI/CD workflow

hCaptcha

For forms, I may remove this in favor of something else, because it could be a privacy and GDPR issue. Also screw Google and their reCaptcha.

Plausible self-hosted

That or coding some metrics and using some opinionated solution myself.

Sentry - runtime prod & dev analysis

Sentry is cool, I will probably not use 80% of their features, but when doing CSP and all sorts of reporting, this came in very handy. I don't really see an alternative with sveltekit.

Playwright - headless browser target testing

TODO, probably sometime, It can be useful with the service posts.

Dockerfile

Selfhosting this is the only way. I used ansible and terraform to get this thing in the air together with the analytics platform. It's on AWS for now,