@@ -184,11 +184,65 @@ For example, seed.sql contains:
184184- Video and image assets are stored in /assets directory and referenced using ~/assets path
185185- NEVER overwrite existing .env files with .env.example - they may contain important local configuration
186186- ALWAYS examine seed.sql before implementing features to understand available test data
187+
188+ ### Page Routing and Navigation
189+
187190- ALWAYS use the /coming-soon/[page] route for links to pages that don't exist yet:
188191 - The route automatically displays a "Coming Soon" message with the page name
189192 - Example: Use `/coming-soon/about` instead of `/about` for unimplemented pages
190193 - Exception: Keep direct links for implemented pages (e.g., `/projects`)
191194 - This helps users understand which features are available vs. in development
195+
196+ ### Page Styling Guidelines
197+
198+ When creating new pages, follow these styling conventions:
199+
200+ - Use consistent max-width containers:
201+
202+ ```html
203+ <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
204+ ```
205+
206+ - Follow proper heading hierarchy:
207+
208+ ```html
209+ <h1 class="text-3xl font-bold text-gray-900 mb-4">Page Title</h1>
210+ <h2 class="text-xl font-semibold text-gray-900 mb-3">Section Title</h2>
211+ ```
212+
213+ - Use card-based layouts for content sections:
214+
215+ ```html
216+ <div class="bg-white rounded-lg shadow-sm overflow-hidden">
217+ <div class="p-6">
218+ <!-- Content here -->
219+ </div>
220+ </div>
221+ ```
222+
223+ - Implement responsive grids:
224+
225+ ```html
226+ <div class="grid grid-cols-1 lg:grid-cols-3 gap-8">
227+ <div class="lg:col-span-2">Main Content</div>
228+ <div>Sidebar</div>
229+ </div>
230+ ```
231+
232+ - Add hover states for interactive elements:
233+
234+ ```html
235+ <button class="bg-blue-500 hover:bg-blue-600 transition-colors">
236+ ```
237+
238+ - Use consistent spacing:
239+ - Vertical spacing between sections: mb-8
240+ - Padding inside cards: p-6
241+ - Grid gaps: gap-8
242+ - Form field spacing: space-y-4
243+
244+ ### Content Examination
245+
192246- When examining any codeforphilly.org URL, ALWAYS use the puppeteer screenshot command first:
193247
194248 ```bash
0 commit comments