project-scaffold
Scaffold a Vite + TypeScript personal dashboard project with the correct directory structure, dependencies, and configuration files.
- License 许可
- MIT
- 所属仓库
- AG064/OpenSpace
- 最近更新
- 2026-10-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- project-scaffold
- description
- Scaffold a Vite + TypeScript personal dashboard project with the correct directory structure, dependencies, and configuration files.
02 资源文件 1
- 其他.skill_id31 B
03 SKILL.md 正文
Project Scaffold
Set up a new Vite + TypeScript project for a personal daily monitoring dashboard.
Directory Structure
my-daily-monitor/
├── index.html
├── package.json
├── tsconfig.json
├── vite.config.ts
├── api/ # Serverless API proxy endpoints (Vercel)
│ └── stocks.ts
├── src/
│ ├── main.ts # Entry point
│ ├── components/ # Panel components
│ │ ├── Panel.ts # Base panel class
│ │ ├── StockPanel.ts
│ │ ├── NewsPanel.ts
│ │ └── index.ts
│ ├── services/ # Data fetching services
│ │ ├── stock-market.ts
│ │ ├── news.ts
│ │ └── index.ts
│ ├── utils/ # Utilities
│ │ ├── circuit-breaker.ts
│ │ ├── sparkline.ts
│ │ ├── format.ts
│ │ └── index.ts
│ ├── config/ # Panel config, API endpoints
│ │ └── panels.ts
│ └── styles/
│ └── main.css
└── skills/ # OpenSpace skill files
package.json
{
"name": "my-daily-monitor",
"private": true,
"version": "0.1.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "tsc && vite build",
"preview": "vite preview"
},
"devDependencies": {
"typescript": "^5.7.2",
"vite": "^6.0.7"
}
}
tsconfig.json
{
"compilerOptions": {
"target": "ES2022",
"module": "ESNext",
"moduleResolution": "bundler",
"strict": true,
"jsx": "preserve",
"resolveJsonModule": true,
"isolatedModules": true,
"esModuleInterop": true,
"lib": ["ES2022", "DOM", "DOM.Iterable"],
"skipLibCheck": true,
"noEmit": true,
"paths": {
"@/*": ["./src/*"]
},
"baseUrl": "."
},
"include": ["src"]
}
vite.config.ts
import { defineConfig } from 'vite';
import { resolve } from 'path';
export default defineConfig({
resolve: {
alias: {
'@': resolve(__dirname, 'src'),
},
},
server: {
port: 5173,
},
});
index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>My Daily Monitor</title>
<link rel="stylesheet" href="/src/styles/main.css" />
</head>
<body>
<div id="app">
<header class="app-header">
<h1>My Daily Monitor</h1>
<span class="app-clock" id="headerClock"></span>
</header>
<main class="main-content">
<div class="panels-grid" id="panelsGrid"></div>
</main>
</div>
<script type="module" src="/src/main.ts"></script>
</body>
</html>
src/main.ts (Entry Point)
import './styles/main.css';
// Import panels
import { StockPanel } from './components/StockPanel';
import { NewsPanel } from './components/NewsPanel';
// ... other panels
const grid = document.getElementById('panelsGrid')!;
// Instantiate and mount panels
const panels = [
new StockPanel(),
new NewsPanel(),
// ... more panels
];
for (const panel of panels) {
grid.appendChild(panel.getElement());
}
// Header clock
function updateClock(): void {
const el = document.getElementById('headerClock');
if (el) el.textContent = new Date().toLocaleTimeString();
}
updateClock();
setInterval(updateClock, 1000);
Key Conventions
- No framework — vanilla TypeScript with DOM API
- Each panel is a class in
src/components/ - Each service is a module in
src/services/ - CSS uses custom properties for theming
- Vite handles bundling, HMR, and path aliases
- API proxy endpoints go in
api/for serverless deployment - Panel config in
src/config/panels.tscontrols which panels are enabled
04 同仓库更多 Skills
write-special-chars-ts-check
Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.
write-special-chars-readback
Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of /tmp helper scripts.
write-special-chars-heredoc
Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) by using a Python heredoc script executed via shell.
worldmonitor-reference
Curated architecture index of the WorldMonitor open-source dashboard. Reference for extracting patterns — vanilla TypeScript, Panel class hierarchy, service layer, CSS grid, API edge functions, refresh scheduler, and 60+ data source integrations.
virtual-list
Implement efficient virtual scrolling for rendering large lists with DOM recycling, chunk-based rendering, and performance optimizations
verify-directory-structure
Diagnose and resolve file access issues by first verifying the directory structure.