val-birthday

Celebrate Val's birthday.

Content:

• val-birthday
  • Install
    • One-time setup
      • DB
      • Quotes API key
  • Run
  • Test
  • Build
  • Tech
    • Options considered

Install

npm install

One-time setup

You should end up with an .env file (similar to .env-sample):

DB

Set up vercel kv, eg:

vercel link
vercel env pull .env.development.local
# rename to work around some issue with the no-config kv setup
mv .env.development.local .env

Quotes API key

Optionally sign up to api-ninjas and set API key in .env to get quotes when generating knowledge:

API_NINJAS_KEY="<your-api-key>"

Run

# start dev server and open app in browser
npm run dev -- --open

Test

# unit & integration tests
npm test

Build

Prod version:

npm run build

Preview the production build: npm run preview.

Tech

• web - a tool that supports SSR + progressive enhancement and SPA: svelte-kit.
• DB - a key-value store with a reasonable free tier: vercel-kv.
• hosting - a cloud service with a reasonable free tier: vercel.

Options considered

• lang:
  • ts
  • alternatives:
    • rust
      • https://kerkour.com/rust-functional-programming
      • https://www.rust-lang.org/learn/get-started
• web:
  • svelte
    • sveltekit
  • alternatives:
    • solidjs
      • with Astro as Static-Site Generation (SSG)?
    • vue
      • options - ref https://vuejs.org/guide/extras/ways-of-using-vue.html:
        • ? Standalone Script - https://github.com/vuejs/petite-vue
        • ? Fullstack / SSR - https://nuxt.com/
    • feathers
    • https://www.phoenixframework.org/
    • https://nextjs.org/
      • on top of react
  • doc
    • https://survey.stackoverflow.co/2023/#section-admired-and-desired-web-frameworks-and-technologies
    • https://2022.stateofjs.com/en-US/libraries/front-end-frameworks/
• hosting:
  • vercel free - https://vercel.com/templates/svelte/sveltekit-boilerplate
• DB:
  • https://vercel.com/storage/kv
    • https://vercel.com/docs/storage/vercel-kv/quickstart
    • https://vercel.com/templates/svelte/kv-redis-sveltekit