Initial project setup

davidlbowman · davidlbowman · commit 5c0ff36cf6e7 · 2025-12-07T15:22:11.000-06:00
- Initialize Bun + Astro with React integration
- Configure Tailwind CSS v4 with shadcn/ui
- Set up Biome for linting and formatting
- Add lint:fix and typecheck scripts
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,27 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# jetbrains setting folder
+.idea/
+
+# docs (local strategy/planning docs)
+docs/
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
@@ -0,0 +1,4 @@
+{
+	"recommendations": ["astro-build.astro-vscode"],
+	"unwantedRecommendations": []
+}
diff --git a/.vscode/launch.json b/.vscode/launch.json
@@ -0,0 +1,11 @@
+{
+	"version": "0.2.0",
+	"configurations": [
+		{
+			"command": "./node_modules/.bin/astro dev",
+			"name": "Development server",
+			"request": "launch",
+			"type": "node-terminal"
+		}
+	]
+}
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1,32 @@
+# Spotify Pomodoro
+
+A Spotify-integrated pomodoro timer app.
+
+## Tech Stack
+
+- **Runtime**: Bun
+- **Framework**: Astro with React
+- **Styling**: Tailwind CSS v4 + shadcn/ui
+- **Linting/Formatting**: Biome
+
+## Commands
+
+- `bun run dev` - Start development server
+- `bun run build` - Build for production
+- `bun run preview` - Preview production build
+- `bun run lint` - Check linting
+- `bun run lint:fix` - Fix linting issues
+- `bun run typecheck` - Run type checking
+
+## Project Structure
+
+- `src/pages/` - Astro pages
+- `src/components/ui/` - shadcn/ui components
+- `src/styles/` - Global CSS with Tailwind
+- `src/lib/` - Utility functions
+
+## Notes
+
+- Use `@/` path alias for imports from `src/`
+- React components need `client:load` directive in Astro for interactivity
+- Biome is configured to skip Tailwind CSS files (global.css)
diff --git a/README.md b/README.md
@@ -0,0 +1,30 @@
+# Spotify Pomodoro
+
+A pomodoro timer app that integrates with your Spotify account to play music during focus sessions.
+
+## Getting Started
+
+```bash
+bun install
+bun run dev
+```
+
+## Commands
+
+| Command             | Action                                      |
+| :------------------ | :------------------------------------------ |
+| `bun install`       | Install dependencies                        |
+| `bun run dev`       | Start local dev server at `localhost:4321`  |
+| `bun run build`     | Build production site to `./dist/`          |
+| `bun run preview`   | Preview production build locally            |
+| `bun run lint`      | Check for linting issues                    |
+| `bun run lint:fix`  | Fix linting issues                          |
+| `bun run typecheck` | Run TypeScript type checking                |
+
+## Tech Stack
+
+- [Astro](https://astro.build) - Web framework
+- [React](https://react.dev) - UI components
+- [Tailwind CSS](https://tailwindcss.com) - Styling
+- [shadcn/ui](https://ui.shadcn.com) - Component library
+- [Biome](https://biomejs.dev) - Linting and formatting
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -0,0 +1,15 @@
+// @ts-check
+
+import react from "@astrojs/react";
+
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig } from "astro/config";
+
+// https://astro.build/config
+export default defineConfig({
+	vite: {
+		plugins: [tailwindcss()],
+	},
+
+	integrations: [react()],
+});
diff --git a/biome.json b/biome.json
@@ -0,0 +1,38 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
+	"vcs": {
+		"enabled": true,
+		"clientKind": "git",
+		"useIgnoreFile": true
+	},
+	"files": {
+		"ignoreUnknown": false,
+		"includes": ["**", "!src/styles/global.css"]
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab"
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true,
+			"correctness": {
+				"noUnusedImports": "off"
+			}
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
+}
diff --git a/bun.lock b/bun.lock
diff --git a/components.json b/components.json
@@ -0,0 +1,22 @@
+{
+	"$schema": "https://ui.shadcn.com/schema.json",
+	"style": "new-york",
+	"rsc": false,
+	"tsx": true,
+	"tailwind": {
+		"config": "",
+		"css": "src/styles/global.css",
+		"baseColor": "neutral",
+		"cssVariables": true,
+		"prefix": ""
+	},
+	"iconLibrary": "lucide",
+	"aliases": {
+		"components": "@/components",
+		"utils": "@/lib/utils",
+		"ui": "@/components/ui",
+		"lib": "@/lib",
+		"hooks": "@/hooks"
+	},
+	"registries": {}
+}
diff --git a/package.json b/package.json
@@ -0,0 +1,35 @@
+{
+	"name": "spotify-pomodoro",
+	"type": "module",
+	"version": "0.0.1",
+	"scripts": {
+		"dev": "astro dev",
+		"build": "astro build",
+		"preview": "astro preview",
+		"astro": "astro",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"typecheck": "astro check"
+	},
+	"dependencies": {
+		"@astrojs/react": "^4.4.2",
+		"@radix-ui/react-slot": "^1.2.4",
+		"@tailwindcss/vite": "^4.1.17",
+		"@types/react": "^19.2.7",
+		"@types/react-dom": "^19.2.3",
+		"astro": "^5.16.4",
+		"class-variance-authority": "^0.7.1",
+		"clsx": "^2.1.1",
+		"lucide-react": "^0.556.0",
+		"react": "^19.2.1",
+		"react-dom": "^19.2.1",
+		"tailwind-merge": "^3.4.0",
+		"tailwindcss": "^4.1.17"
+	},
+	"devDependencies": {
+		"@astrojs/check": "^0.9.6",
+		"@biomejs/biome": "^2.3.8",
+		"tw-animate-css": "^1.4.0",
+		"typescript": "^5.9.3"
+	}
+}
diff --git a/public/favicon.svg b/public/favicon.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 128 128">
+    <path d="M50.4 78.5a75.1 75.1 0 0 0-28.5 6.9l24.2-65.7c.7-2 1.9-3.2 3.4-3.2h29c1.5 0 2.7 1.2 3.4 3.2l24.2 65.7s-11.6-7-28.5-7L67 45.5c-.4-1.7-1.6-2.8-2.9-2.8-1.3 0-2.5 1.1-2.9 2.7L50.4 78.5Zm-1.1 28.2Zm-4.2-20.2c-2 6.6-.6 15.8 4.2 20.2a17.5 17.5 0 0 1 .2-.7 5.5 5.5 0 0 1 5.7-4.5c2.8.1 4.3 1.5 4.7 4.7.2 1.1.2 2.3.2 3.5v.4c0 2.7.7 5.2 2.2 7.4a13 13 0 0 0 5.7 4.9v-.3l-.2-.3c-1.8-5.6-.5-9.5 4.4-12.8l1.5-1a73 73 0 0 0 3.2-2.2 16 16 0 0 0 6.8-11.4c.3-2 .1-4-.6-6l-.8.6-1.6 1a37 37 0 0 1-22.4 2.7c-5-.7-9.7-2-13.2-6.2Z" />
+    <style>
+        path { fill: #000; }
+        @media (prefers-color-scheme: dark) {
+            path { fill: #FFF; }
+        }
+    </style>
+</svg>
diff --git a/src/components/ui/button.tsx b/src/components/ui/button.tsx
@@ -0,0 +1,60 @@
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+import type * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const buttonVariants = cva(
+	"inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+	{
+		variants: {
+			variant: {
+				default: "bg-primary text-primary-foreground hover:bg-primary/90",
+				destructive:
+					"bg-destructive text-white hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+				outline:
+					"border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50",
+				secondary:
+					"bg-secondary text-secondary-foreground hover:bg-secondary/80",
+				ghost:
+					"hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
+				link: "text-primary underline-offset-4 hover:underline",
+			},
+			size: {
+				default: "h-9 px-4 py-2 has-[>svg]:px-3",
+				sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5",
+				lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
+				icon: "size-9",
+				"icon-sm": "size-8",
+				"icon-lg": "size-10",
+			},
+		},
+		defaultVariants: {
+			variant: "default",
+			size: "default",
+		},
+	},
+);
+
+function Button({
+	className,
+	variant,
+	size,
+	asChild = false,
+	...props
+}: React.ComponentProps<"button"> &
+	VariantProps<typeof buttonVariants> & {
+		asChild?: boolean;
+	}) {
+	const Comp = asChild ? Slot : "button";
+
+	return (
+		<Comp
+			data-slot="button"
+			className={cn(buttonVariants({ variant, size, className }))}
+			{...props}
+		/>
+	);
+}
+
+export { Button, buttonVariants };
diff --git a/src/lib/utils.ts b/src/lib/utils.ts
@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+	return twMerge(clsx(inputs));
+}
diff --git a/src/pages/index.astro b/src/pages/index.astro
@@ -0,0 +1,20 @@
+---
+import "@/styles/global.css";
+import { Button } from "@/components/ui/button";
+---
+
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+		<meta name="viewport" content="width=device-width" />
+		<meta name="generator" content={Astro.generator} />
+		<title>Spotify Pomodoro</title>
+	</head>
+	<body class="min-h-screen bg-background text-foreground">
+		<main class="container mx-auto p-8">
+			<h1 class="text-3xl font-bold mb-4">Spotify Pomodoro</h1>
+			<Button client:load>Get Started</Button>
+		</main>
+	</body>
+</html>
diff --git a/src/styles/global.css b/src/styles/global.css
diff --git a/tsconfig.json b/tsconfig.json

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +{
 +	"recommendations": ["astro-build.astro-vscode"],
 +	"unwantedRecommendations": []
 +}