added more file type specific instructions
I hope that coding results will be better and more consistent
This commit is contained in:
@@ -0,0 +1,484 @@
|
||||
---
|
||||
description: 'Instructions for writing CSS following project conventions and best practices'
|
||||
applyTo: '**/*.css,**/*.vue'
|
||||
---
|
||||
|
||||
# CSS Development Instructions
|
||||
|
||||
Follow project-specific CSS conventions and modern best practices.
|
||||
|
||||
## Scoped Styles in Vue Components
|
||||
|
||||
### Always Use Scoped Styles
|
||||
```vue
|
||||
<style scoped>
|
||||
.component-class {
|
||||
/* Styles only apply to this component */
|
||||
}
|
||||
</style>
|
||||
```
|
||||
|
||||
**Critical**: Use `scoped` attribute to prevent style conflicts between components.
|
||||
|
||||
## Layout Patterns
|
||||
|
||||
### Flexbox for Component Layouts
|
||||
Standard pattern for headers, modals, and lists:
|
||||
|
||||
```css
|
||||
.header-content {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 15px; /* Use gap instead of margin */
|
||||
}
|
||||
|
||||
.modal-footer {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
gap: 10px;
|
||||
}
|
||||
```
|
||||
|
||||
### Common Flex Patterns
|
||||
```css
|
||||
/* Horizontal layout with spacing */
|
||||
.horizontal-layout {
|
||||
display: flex;
|
||||
gap: 10px;
|
||||
align-items: center;
|
||||
}
|
||||
|
||||
/* Vertical centering */
|
||||
.centered {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
height: 100vh;
|
||||
}
|
||||
|
||||
/* Space between items */
|
||||
.space-between {
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
align-items: center;
|
||||
}
|
||||
```
|
||||
|
||||
## Modal Dialog Styling
|
||||
|
||||
### Standard Modal Pattern
|
||||
```css
|
||||
/* Overlay - covers entire viewport */
|
||||
.modal-overlay {
|
||||
position: fixed;
|
||||
top: 0;
|
||||
left: 0;
|
||||
right: 0;
|
||||
bottom: 0;
|
||||
background: rgba(0, 0, 0, 0.5);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
z-index: 1000;
|
||||
}
|
||||
|
||||
/* Modal content container */
|
||||
.modal-content {
|
||||
background: white;
|
||||
border-radius: 8px;
|
||||
width: 90%;
|
||||
max-width: 500px;
|
||||
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
|
||||
}
|
||||
|
||||
/* Modal sections */
|
||||
.modal-header {
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
align-items: center;
|
||||
padding: 20px;
|
||||
border-bottom: 1px solid #dee2e6;
|
||||
}
|
||||
|
||||
.modal-body {
|
||||
padding: 20px;
|
||||
position: relative; /* For loading overlays */
|
||||
}
|
||||
|
||||
.modal-footer {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
gap: 10px;
|
||||
padding: 20px;
|
||||
border-top: 1px solid #dee2e6;
|
||||
}
|
||||
```
|
||||
|
||||
## Button Styling
|
||||
|
||||
### Standard Button Styles
|
||||
```css
|
||||
/* Primary action button */
|
||||
.btn-primary,
|
||||
.btn-export {
|
||||
padding: 10px 20px;
|
||||
border: 1px solid #007bff;
|
||||
border-radius: 6px;
|
||||
background: #007bff;
|
||||
color: white;
|
||||
cursor: pointer;
|
||||
font-weight: 500;
|
||||
transition: all 0.2s ease;
|
||||
}
|
||||
|
||||
.btn-primary:hover:not(:disabled) {
|
||||
background: #0056b3;
|
||||
border-color: #0056b3;
|
||||
}
|
||||
|
||||
.btn-primary:disabled {
|
||||
opacity: 0.6;
|
||||
cursor: not-allowed;
|
||||
}
|
||||
|
||||
/* Cancel/secondary button */
|
||||
.btn-cancel {
|
||||
padding: 10px 20px;
|
||||
border: 1px solid #dee2e6;
|
||||
border-radius: 6px;
|
||||
background: #f8f9fa;
|
||||
color: #495057;
|
||||
cursor: pointer;
|
||||
font-weight: 500;
|
||||
transition: all 0.2s ease;
|
||||
}
|
||||
|
||||
.btn-cancel:hover {
|
||||
background: #e9ecef;
|
||||
border-color: #adb5bd;
|
||||
}
|
||||
|
||||
/* Icon-only button */
|
||||
.export-button-small {
|
||||
width: 40px;
|
||||
height: 40px;
|
||||
padding: 0;
|
||||
border: 1px solid #007bff;
|
||||
border-radius: 8px;
|
||||
background: #007bff;
|
||||
color: white;
|
||||
font-size: 1.2rem;
|
||||
cursor: pointer;
|
||||
transition: all 0.2s ease;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.export-button-small:hover {
|
||||
background: #0056b3;
|
||||
transform: scale(1.05);
|
||||
}
|
||||
```
|
||||
|
||||
## Form Elements
|
||||
|
||||
### Input Styling
|
||||
```css
|
||||
.template-select,
|
||||
input[type="text"],
|
||||
input[type="email"] {
|
||||
width: 100%;
|
||||
padding: 10px 12px;
|
||||
border: 1px solid #dee2e6;
|
||||
border-radius: 6px;
|
||||
background: white;
|
||||
color: #495057;
|
||||
font-size: 0.95rem;
|
||||
}
|
||||
|
||||
.template-select:focus,
|
||||
input:focus {
|
||||
outline: none;
|
||||
border-color: #007bff;
|
||||
box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);
|
||||
}
|
||||
|
||||
input:disabled,
|
||||
select:disabled {
|
||||
opacity: 0.6;
|
||||
cursor: not-allowed;
|
||||
background: #e9ecef;
|
||||
}
|
||||
```
|
||||
|
||||
### Checkbox Styling
|
||||
```css
|
||||
.checkbox-label {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
cursor: pointer;
|
||||
user-select: none;
|
||||
}
|
||||
|
||||
.checkbox-label input[type="checkbox"] {
|
||||
width: 18px;
|
||||
height: 18px;
|
||||
cursor: pointer;
|
||||
}
|
||||
```
|
||||
|
||||
## Loading Animations
|
||||
|
||||
### Spinner Animation
|
||||
```css
|
||||
.spinner {
|
||||
border: 4px solid #f3f3f3;
|
||||
border-top: 4px solid #007bff;
|
||||
border-radius: 50%;
|
||||
width: 50px;
|
||||
height: 50px;
|
||||
animation: spin 1s linear infinite;
|
||||
margin-bottom: 15px;
|
||||
}
|
||||
|
||||
@keyframes spin {
|
||||
0% { transform: rotate(0deg); }
|
||||
100% { transform: rotate(360deg); }
|
||||
}
|
||||
```
|
||||
|
||||
### Loading Overlay
|
||||
```css
|
||||
.loading-overlay {
|
||||
position: absolute;
|
||||
top: 0;
|
||||
left: 0;
|
||||
right: 0;
|
||||
bottom: 0;
|
||||
background: rgba(255, 255, 255, 0.95);
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
justify-content: center;
|
||||
align-items: center;
|
||||
z-index: 10;
|
||||
}
|
||||
|
||||
.loading-overlay p {
|
||||
color: #007bff;
|
||||
font-weight: 500;
|
||||
margin: 0;
|
||||
}
|
||||
```
|
||||
|
||||
## Color Scheme
|
||||
|
||||
### Standard Colors
|
||||
```css
|
||||
/* Primary */
|
||||
--primary: #007bff;
|
||||
--primary-hover: #0056b3;
|
||||
|
||||
/* Text */
|
||||
--text-primary: #333;
|
||||
--text-secondary: #495057;
|
||||
--text-muted: #666;
|
||||
|
||||
/* Backgrounds */
|
||||
--bg-light: #f8f9fa;
|
||||
--bg-gray: #e9ecef;
|
||||
|
||||
/* Borders */
|
||||
--border-light: #dee2e6;
|
||||
--border-dark: #adb5bd;
|
||||
|
||||
/* Semantic colors */
|
||||
--success: #28a745;
|
||||
--danger: #dc3545;
|
||||
--warning: #ffc107;
|
||||
```
|
||||
|
||||
Use these consistently across components for visual coherence.
|
||||
|
||||
## Spacing System
|
||||
|
||||
### Use Consistent Spacing
|
||||
```css
|
||||
/* Prefer these spacing values */
|
||||
gap: 8px; /* Tight spacing */
|
||||
gap: 10px; /* Default spacing */
|
||||
gap: 15px; /* Medium spacing */
|
||||
gap: 20px; /* Large spacing */
|
||||
|
||||
padding: 10px 12px; /* Inputs */
|
||||
padding: 20px; /* Modal sections */
|
||||
```
|
||||
|
||||
## Typography
|
||||
|
||||
### Font Sizing
|
||||
```css
|
||||
h2 {
|
||||
font-size: 1.5rem;
|
||||
margin: 0;
|
||||
color: #333;
|
||||
}
|
||||
|
||||
h3 {
|
||||
font-size: 1.25rem;
|
||||
margin: 0;
|
||||
color: #333;
|
||||
}
|
||||
|
||||
p, span {
|
||||
font-size: 0.95rem;
|
||||
color: #495057;
|
||||
}
|
||||
|
||||
small {
|
||||
font-size: 0.875rem;
|
||||
color: #666;
|
||||
}
|
||||
```
|
||||
|
||||
### Font Weight
|
||||
```css
|
||||
font-weight: 400; /* Normal */
|
||||
font-weight: 500; /* Medium (buttons, labels) */
|
||||
font-weight: 600; /* Semibold (headings) */
|
||||
```
|
||||
|
||||
## Transitions and Animations
|
||||
|
||||
### Standard Transitions
|
||||
```css
|
||||
/* Buttons, interactive elements */
|
||||
transition: all 0.2s ease;
|
||||
|
||||
/* Background changes */
|
||||
transition: background 0.3s ease;
|
||||
|
||||
/* Transform animations */
|
||||
transition: transform 0.2s ease;
|
||||
```
|
||||
|
||||
### Hover Effects
|
||||
```css
|
||||
button:hover {
|
||||
transform: scale(1.02); /* Subtle scale */
|
||||
}
|
||||
|
||||
.card:hover {
|
||||
box-shadow: 0 6px 12px rgba(0, 0, 0, 0.15);
|
||||
}
|
||||
```
|
||||
|
||||
## Responsive Design
|
||||
|
||||
### Mobile-First Approach
|
||||
```css
|
||||
/* Base styles (mobile) */
|
||||
.modal-content {
|
||||
width: 90%;
|
||||
max-width: 500px;
|
||||
}
|
||||
|
||||
/* Tablet and up */
|
||||
@media (min-width: 768px) {
|
||||
.modal-content {
|
||||
width: 600px;
|
||||
}
|
||||
}
|
||||
|
||||
/* Desktop */
|
||||
@media (min-width: 1024px) {
|
||||
.modal-content {
|
||||
width: 700px;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Always use `scoped`** on Vue component styles
|
||||
2. **Use flexbox for layouts** instead of floats or positioning
|
||||
3. **Use `gap` property** instead of margins for spacing
|
||||
4. **Keep selectors simple** - avoid deep nesting
|
||||
5. **Use relative units** (`rem`, `em`) for font sizes
|
||||
6. **Add transitions** for interactive elements
|
||||
7. **Use CSS variables** for repeated values
|
||||
8. **Keep z-index organized** (modals: 1000, dropdowns: 100, etc.)
|
||||
9. **Test hover states** for all interactive elements
|
||||
10. **Include disabled states** for buttons and inputs
|
||||
|
||||
## Anti-Patterns to Avoid
|
||||
|
||||
❌ Don't use `!important` unless absolutely necessary
|
||||
❌ Don't use inline styles in templates - use classes
|
||||
❌ Don't use fixed pixel widths for responsive layouts
|
||||
❌ Don't nest selectors more than 3 levels deep
|
||||
❌ Don't use IDs for styling - use classes
|
||||
❌ Don't forget `:hover`, `:focus`, `:disabled` states
|
||||
❌ Don't use `position: absolute` unless necessary
|
||||
❌ Don't forget to test in different viewport sizes
|
||||
❌ Don't use vendor prefixes manually - use autoprefixer
|
||||
|
||||
## Common Component Patterns
|
||||
|
||||
### Close Button
|
||||
```css
|
||||
.close-button {
|
||||
background: none;
|
||||
border: none;
|
||||
font-size: 1.5rem;
|
||||
color: #999;
|
||||
cursor: pointer;
|
||||
padding: 0;
|
||||
width: 30px;
|
||||
height: 30px;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
}
|
||||
|
||||
.close-button:hover {
|
||||
color: #333;
|
||||
}
|
||||
```
|
||||
|
||||
### Full-Height Container
|
||||
```css
|
||||
.character-details {
|
||||
width: 100%;
|
||||
height: 100%;
|
||||
padding: 20px;
|
||||
box-sizing: border-box;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
}
|
||||
```
|
||||
|
||||
### Submenu/Tabs
|
||||
```css
|
||||
.submenu {
|
||||
display: flex;
|
||||
gap: 10px;
|
||||
margin: 20px 0;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.submenu button {
|
||||
padding: 10px 16px;
|
||||
border: 1px solid #dee2e6;
|
||||
border-radius: 6px;
|
||||
background: #f8f9fa;
|
||||
color: #495057;
|
||||
cursor: pointer;
|
||||
transition: all 0.2s ease;
|
||||
}
|
||||
|
||||
.submenu button.active {
|
||||
background: #007bff;
|
||||
color: white;
|
||||
border-color: #007bff;
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user