Nicholai
4445584353
- rewrite readme in casual markdown style - fix bun run deploy command (deploy is reserved)
79 lines
1.8 KiB
Markdown
79 lines
1.8 KiB
Markdown
nicholai.work
|
|
===
|
|
|
|
personal portfolio and blog built with astro. live at https://nicholai.work
|
|
|
|
tech stack
|
|
---
|
|
|
|
- astro - static site framework
|
|
- react - interactive components
|
|
- tailwind css - styling
|
|
- mdx - markdown with jsx
|
|
- cloudflare pages - hosting
|
|
- typescript - type safety
|
|
|
|
commands
|
|
---
|
|
|
|
```bash
|
|
bun install # install deps
|
|
bun dev # dev server at localhost:4321
|
|
bun build # production build
|
|
bun preview # preview with wrangler
|
|
bun run deploy # build and deploy to cloudflare
|
|
```
|
|
|
|
image conversion
|
|
---
|
|
|
|
```bash
|
|
bun run convert:avif:all # convert all images in src/assets/
|
|
bun run convert:avif:jpeg # just jpegs
|
|
bun run convert:avif:png # just pngs
|
|
```
|
|
|
|
blog posts
|
|
---
|
|
|
|
create mdx files in `src/content/blog/`. filename becomes the url slug.
|
|
|
|
frontmatter:
|
|
|
|
```mdx
|
|
---
|
|
title: 'Post Title'
|
|
description: 'brief description for listings and seo'
|
|
pubDate: 'Jan 15 2025'
|
|
heroImage: '../../assets/image.jpg' # optional
|
|
featured: true # optional, shows in hero
|
|
category: 'Case Study' # optional, for filtering
|
|
tags: ['VFX', 'Houdini'] # optional, for related posts
|
|
---
|
|
```
|
|
|
|
images go in `src/assets/` (processed by astro) or `public/media/` (static, use absolute paths like `/media/video.mp4`).
|
|
|
|
project structure
|
|
---
|
|
|
|
```
|
|
src/
|
|
├── assets/ # images processed by astro
|
|
├── components/ # reusable components
|
|
├── content/
|
|
│ ├── blog/ # blog posts (mdx)
|
|
│ ├── pages/ # page content
|
|
│ └── sections/ # homepage sections
|
|
├── layouts/ # page layouts
|
|
├── pages/ # routes
|
|
├── styles/ # global styles
|
|
└── utils/ # utility scripts
|
|
```
|
|
|
|
deployment
|
|
---
|
|
|
|
deployed to cloudflare pages. `bun run deploy` builds and deploys via wrangler.
|
|
for production: `wrangler pages deploy --branch=main`
|