mirror of
https://github.com/pacnpal/thrillwiki_django_no_react.git
synced 2025-12-20 07:11:08 -05:00
Add development server and package management guidelines to documentation
This commit is contained in:
28
.clinerules
Normal file
28
.clinerules
Normal 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.
|
||||||
@@ -73,8 +73,8 @@
|
|||||||
```html
|
```html
|
||||||
<!-- Component Structure -->
|
<!-- Component Structure -->
|
||||||
<div class="component-wrapper">
|
<div class="component-wrapper">
|
||||||
<div class="component-header"></div>
|
<div class="component-header"></div>
|
||||||
<div class="component-content"></div>
|
<div class="component-content"></div>
|
||||||
</div>
|
</div>
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -161,6 +161,34 @@ class ViewTests(TestCase):
|
|||||||
|
|
||||||
## Development Workflows
|
## 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
|
### Feature Development
|
||||||
1. Planning
|
1. Planning
|
||||||
- Technical specification
|
- Technical specification
|
||||||
|
|||||||
Reference in New Issue
Block a user