Add development server and package management guidelines to documentation

This commit is contained in:
pacnpal
2025-02-19 09:56:23 -05:00
parent 5541a5f02d
commit 20ae4862e4
2 changed files with 58 additions and 2 deletions

28
.clinerules Normal file
View File

@@ -0,0 +1,28 @@
# Project Startup Rules
## Development Server
IMPORTANT: Always follow these instructions exactly in this order when starting the development server:
1. First, kill any existing process on port 8000:
```bash
lsof -ti :8000 | xargs kill -9
```
2. Then, delete all __pycache__ directories:
```bash
find . -type d -name "__pycache__" -exec rm -r {} +
```
3. Finally, run the Django development server with Tailwind using UV:
```bash
uv run manage.py tailwind runserver
```
Note: These steps must be followed in exactly this order every time you start the development server to ensure consistent behavior.
## Package Management
IMPORTANT: When a Python package is needed, only use UV to add it:
```bash
uv add <package>
```
Do not attempt to install packages using any other method.

View File

@@ -73,8 +73,8 @@
```html
<!-- Component Structure -->
<div class="component-wrapper">
<div class="component-header"></div>
<div class="component-content"></div>
<div class="component-header"></div>
<div class="component-content"></div>
</div>
```
@@ -161,6 +161,34 @@ class ViewTests(TestCase):
## Development Workflows
### Package Management
IMPORTANT: When adding Python packages to the project, only use UV:
```bash
uv add <package>
```
Do not attempt to install packages using any other method (pip, poetry, etc.).
### Development Server Management
1. Server Startup Process
IMPORTANT: Always follow these steps exactly in this order when starting the development server:
1. First, kill any existing process on port 8000:
```bash
lsof -ti :8000 | xargs kill -9
```
2. Then, delete all __pycache__ directories:
```bash
find . -type d -name "__pycache__" -exec rm -r {} +
```
3. Finally, run the Django development server with Tailwind using UV:
```bash
uv run manage.py tailwind runserver
```
Note: These steps must be followed in exactly this order every time you start the development server to ensure consistent behavior.
### Feature Development
1. Planning
- Technical specification