stack/v1/packages/mosaic/framework/skills/antfu/references/setting-up.md

name, description

name	description
setting-up	Project setup files including .gitignore, GitHub Actions workflows, and VS Code extensions. Use when initializing new projects or adding CI/editor config.

Project Setup

.gitignore

Create when .gitignore is not present:

*.log
*.tgz
.cache
.DS_Store
.eslintcache
.idea
.env
.nuxt
.temp
.output
.turbo
cache
coverage
dist
lib-cov
logs
node_modules
temp

GitHub Actions

Add these workflows when setting up a new project. Skip if workflows already exist. All use sxzz/workflows reusable workflows.

Autofix Workflow

.github/workflows/autofix.yml - Auto-fix linting on PRs:

name: autofix.ci

on: [pull_request]

jobs:
  autofix:
    uses: sxzz/workflows/.github/workflows/autofix.yml@v1
    permissions:
      contents: read

Unit Test Workflow

.github/workflows/unit-test.yml - Run tests on push/PR:

name: Unit Test

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

permissions: {}

jobs:
  unit-test:
    uses: sxzz/workflows/.github/workflows/unit-test.yml@v1

Release Workflow

.github/workflows/release.yml - Publish on tag (library projects only):

name: Release

on:
  push:
    tags:
      - 'v*'

jobs:
  release:
    uses: sxzz/workflows/.github/workflows/release.yml@v1
    with:
      publish: true
    permissions:
      contents: write
      id-token: write

VS Code Extensions

Configure in .vscode/extensions.json:

{
  "recommendations": [
    "dbaeumer.vscode-eslint",
    "antfu.pnpm-catalog-lens",
    "antfu.iconify",
    "antfu.unocss",
    "antfu.slidev",
    "vue.volar"
  ]
}

Extension	Description
dbaeumer.vscode-eslint	ESLint integration for linting and formatting
antfu.pnpm-catalog-lens	Shows pnpm catalog version hints inline
antfu.iconify	Iconify icon preview and autocomplete
antfu.unocss	UnoCSS IntelliSense and syntax highlighting
antfu.slidev	Slidev preview and syntax highlighting
vue.volar	Vue Language Features