fastapi-fullstack 0.1.1__tar.gz → 0.1.3__tar.gz

{fastapi_fullstack-0.1.1 → fastapi_fullstack-0.1.3}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: fastapi-fullstack
-Version: 0.1.1
+Version: 0.1.3
 Summary: Interactive FastAPI project generator with Logfire observability
-Project-URL: Homepage, https://github.com/yourusername/fastapi-gen
-Project-URL: Documentation, https://github.com/yourusername/fastapi-gen#readme
-Project-URL: Repository, https://github.com/yourusername/fastapi-gen
+Project-URL: Homepage, https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template
+Project-URL: Documentation, https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template#readme
+Project-URL: Repository, https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template
 Author-email: Your Name <your@email.com>
 License: MIT
 License-File: LICENSE
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown
   <a href="https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/stargazers"><img src="https://img.shields.io/github/stars/vstorm-co/full-stack-fastapi-nextjs-llm-template?style=flat&logo=github&color=yellow" alt="GitHub Stars"></a>
   <a href="https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/blob/main/LICENSE"><img src="https://img.shields.io/github/license/vstorm-co/full-stack-fastapi-nextjs-llm-template?color=blue" alt="License"></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue?logo=python&logoColor=white" alt="Python"></a>
-  <a href="https://pypi.org/project/fastapi-gen/"><img src="https://img.shields.io/pypi/v/fastapi-gen?color=green&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <a href="https://pypi.org/project/fastapi-fullstack/"><img src="https://img.shields.io/pypi/v/fastapi-fullstack?color=green&logo=pypi&logoColor=white" alt="PyPI"></a>
   <img src="https://img.shields.io/badge/integrations-20%2B-brightgreen" alt="20+ Integrations">
 </p>
 
@@ -51,6 +51,7 @@ Description-Content-Type: text/markdown
 <p align="center">
   <a href="#-why-this-template">Why This Template</a> •
   <a href="#-features">Features</a> •
+  <a href="#-demo">Demo</a> •
   <a href="#-quick-start">Quick Start</a> •
   <a href="#-architecture">Architecture</a> •
   <a href="#-ai-agent">AI Agent</a> •
@@ -58,20 +59,6 @@ Description-Content-Type: text/markdown
   <a href="#-documentation">Documentation</a>
 </p>
 
----
-
-## Star History
-
-<a href="https://www.star-history.com/#vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&legend=top-left">
- <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&theme=dark" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
- </picture>
-</a>
-
----
-
 ## 🎯 Why This Template
 
 Building AI/LLM applications requires more than just an API wrapper. You need:
@@ -131,6 +118,25 @@ This template gives you all of that out of the box, with **20+ configurable inte
 
 ---
 
+## 🎬 Demo
+
+<p align="center">
+  <img src="assets/app_start.gif" alt="FastAPI Fullstack Generator Demo" width="800">
+</p>
+
+### Screenshots
+
+<p align="center">
+  <img src="assets/docs_2.png" alt="API Documentation" width="700"><br><br>
+  <img src="assets/admin.png" alt="Admin Panel" width="700"><br><br>
+  <img src="assets/chat_view_light.png" alt="Chat Interface - Light Mode" width="700"><br><br>
+  <img src="assets/chat_view_dark.png" alt="Chat Interface - Dark Mode" width="700"><br><br>
+  <img src="assets/login.png" alt="Login Page" width="700"><br><br>
+  <img src="assets/register.png" alt="Register Page" width="700">
+</p>
+
+---
+
 ## 🏗️ Architecture
 
 ```mermaid
@@ -201,23 +207,23 @@ See [Architecture Documentation](./docs/architecture.md) for details.
 
 ```bash
 # pip
-pip install fastapi-gen
+pip install fastapi-fullstack
 
 # uv (recommended)
-uv tool install fastapi-gen
+uv tool install fastapi-fullstack
 
 # pipx
-pipx install fastapi-gen
+pipx install fastapi-fullstack
 ```
 
 ### Create Your Project
 
 ```bash
 # Interactive wizard (recommended)
-fastapi-gen new
+fastapi-fullstack new
 
 # Quick mode with options
-fastapi-gen create my_ai_app \
+fastapi-fullstack create my_ai_app \
   --database postgresql \
   --auth jwt \
   --frontend nextjs
@@ -233,6 +239,11 @@ cd backend
 uv sync
 cp .env.example .env
 alembic upgrade head
+
+# Create admin user
+uv run my_ai_app user create --email admin@example.com --password secret123 --superuser
+
+# Start server
 uv run uvicorn app.main:app --reload
 
 # Frontend (new terminal)
@@ -241,9 +252,12 @@ bun install
 bun dev
 ```
 
+> **Note:** The admin user is required to access the SQLAdmin panel at `/admin`. Use the `--superuser` flag to grant full admin privileges.
+
 **Access:**
 - API: http://localhost:8000
 - Docs: http://localhost:8000/docs
+- Admin Panel: http://localhost:8000/admin
 - Frontend: http://localhost:3000
 
 ---
@@ -352,7 +366,7 @@ graph LR
 Enable Logfire and select which components to instrument:
 
 ```bash
-fastapi-gen new
+fastapi-fullstack new
 # ✓ Enable Logfire observability
 #   ✓ Instrument FastAPI
 #   ✓ Instrument Database
@@ -491,7 +505,7 @@ my_project/
 Select what you need:
 
 ```bash
-fastapi-gen new
+fastapi-fullstack new
 # ✓ Redis (caching/sessions)
 # ✓ Rate limiting (slowapi)
 # ✓ Pagination (fastapi-pagination)
@@ -519,6 +533,18 @@ fastapi-gen new
 
 ---
 
+## Star History
+
+<a href="https://www.star-history.com/#vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
+ </picture>
+</a>
+
+---
+
 ## 🙏 Inspiration
 
 This project is inspired by:

{fastapi_fullstack-0.1.1 → fastapi_fullstack-0.1.3}/README.md

@@ -4,7 +4,7 @@
   <a href="https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/stargazers"><img src="https://img.shields.io/github/stars/vstorm-co/full-stack-fastapi-nextjs-llm-template?style=flat&logo=github&color=yellow" alt="GitHub Stars"></a>
   <a href="https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/blob/main/LICENSE"><img src="https://img.shields.io/github/license/vstorm-co/full-stack-fastapi-nextjs-llm-template?color=blue" alt="License"></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue?logo=python&logoColor=white" alt="Python"></a>
-  <a href="https://pypi.org/project/fastapi-gen/"><img src="https://img.shields.io/pypi/v/fastapi-gen?color=green&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <a href="https://pypi.org/project/fastapi-fullstack/"><img src="https://img.shields.io/pypi/v/fastapi-fullstack?color=green&logo=pypi&logoColor=white" alt="PyPI"></a>
   <img src="https://img.shields.io/badge/integrations-20%2B-brightgreen" alt="20+ Integrations">
 </p>
 
@@ -16,6 +16,7 @@
 <p align="center">
   <a href="#-why-this-template">Why This Template</a> •
   <a href="#-features">Features</a> •
+  <a href="#-demo">Demo</a> •
   <a href="#-quick-start">Quick Start</a> •
   <a href="#-architecture">Architecture</a> •
   <a href="#-ai-agent">AI Agent</a> •
@@ -23,20 +24,6 @@
   <a href="#-documentation">Documentation</a>
 </p>
 
----
-
-## Star History
-
-<a href="https://www.star-history.com/#vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&legend=top-left">
- <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&theme=dark" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
- </picture>
-</a>
-
----
-
 ## 🎯 Why This Template
 
 Building AI/LLM applications requires more than just an API wrapper. You need:
@@ -96,6 +83,25 @@ This template gives you all of that out of the box, with **20+ configurable inte
 
 ---
 
+## 🎬 Demo
+
+<p align="center">
+  <img src="assets/app_start.gif" alt="FastAPI Fullstack Generator Demo" width="800">
+</p>
+
+### Screenshots
+
+<p align="center">
+  <img src="assets/docs_2.png" alt="API Documentation" width="700"><br><br>
+  <img src="assets/admin.png" alt="Admin Panel" width="700"><br><br>
+  <img src="assets/chat_view_light.png" alt="Chat Interface - Light Mode" width="700"><br><br>
+  <img src="assets/chat_view_dark.png" alt="Chat Interface - Dark Mode" width="700"><br><br>
+  <img src="assets/login.png" alt="Login Page" width="700"><br><br>
+  <img src="assets/register.png" alt="Register Page" width="700">
+</p>
+
+---
+
 ## 🏗️ Architecture
 
 ```mermaid
@@ -166,23 +172,23 @@ See [Architecture Documentation](./docs/architecture.md) for details.
 
 ```bash
 # pip
-pip install fastapi-gen
+pip install fastapi-fullstack
 
 # uv (recommended)
-uv tool install fastapi-gen
+uv tool install fastapi-fullstack
 
 # pipx
-pipx install fastapi-gen
+pipx install fastapi-fullstack
 ```
 
 ### Create Your Project
 
 ```bash
 # Interactive wizard (recommended)
-fastapi-gen new
+fastapi-fullstack new
 
 # Quick mode with options
-fastapi-gen create my_ai_app \
+fastapi-fullstack create my_ai_app \
   --database postgresql \
   --auth jwt \
   --frontend nextjs
@@ -198,6 +204,11 @@ cd backend
 uv sync
 cp .env.example .env
 alembic upgrade head
+
+# Create admin user
+uv run my_ai_app user create --email admin@example.com --password secret123 --superuser
+
+# Start server
 uv run uvicorn app.main:app --reload
 
 # Frontend (new terminal)
@@ -206,9 +217,12 @@ bun install
 bun dev
 ```
 
+> **Note:** The admin user is required to access the SQLAdmin panel at `/admin`. Use the `--superuser` flag to grant full admin privileges.
+
 **Access:**
 - API: http://localhost:8000
 - Docs: http://localhost:8000/docs
+- Admin Panel: http://localhost:8000/admin
 - Frontend: http://localhost:3000
 
 ---
@@ -317,7 +331,7 @@ graph LR
 Enable Logfire and select which components to instrument:
 
 ```bash
-fastapi-gen new
+fastapi-fullstack new
 # ✓ Enable Logfire observability
 #   ✓ Instrument FastAPI
 #   ✓ Instrument Database
@@ -456,7 +470,7 @@ my_project/
 Select what you need:
 
 ```bash
-fastapi-gen new
+fastapi-fullstack new
 # ✓ Redis (caching/sessions)
 # ✓ Rate limiting (slowapi)
 # ✓ Pagination (fastapi-pagination)
@@ -484,6 +498,18 @@ fastapi-gen new
 
 ---
 
+## Star History
+
+<a href="https://www.star-history.com/#vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
+ </picture>
+</a>
+
+---
+
 ## 🙏 Inspiration
 
 This project is inspired by:

{fastapi_fullstack-0.1.1 → fastapi_fullstack-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-fullstack"
-version = "0.1.1"
+version = "0.1.3"
 description = "Interactive FastAPI project generator with Logfire observability"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -38,12 +38,12 @@ dev = [
 ]
 
 [project.scripts]
-fastapi-gen = "fastapi_gen.cli:main"
+fastapi-fullstack = "fastapi_gen.cli:main"
 
 [project.urls]
-Homepage = "https://github.com/yourusername/fastapi-gen"
-Documentation = "https://github.com/yourusername/fastapi-gen#readme"
-Repository = "https://github.com/yourusername/fastapi-gen"
+Homepage = "https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template"
+Documentation = "https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template#readme"
+Repository = "https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template"
 
 [build-system]
 requires = ["hatchling"]

{fastapi_fullstack-0.1.1 → fastapi_fullstack-0.1.3}/template/hooks/post_gen_project.py

@@ -9,6 +9,7 @@ import sys
 # Get cookiecutter variables
 use_frontend = "{{ cookiecutter.use_frontend }}" == "True"
 generate_env = "{{ cookiecutter.generate_env }}" == "True"
+enable_i18n = "{{ cookiecutter.enable_i18n }}" == "True"
 
 # Remove frontend folder if not using frontend
 if not use_frontend:
@@ -17,6 +18,13 @@ if not use_frontend:
         shutil.rmtree(frontend_dir)
         print("Removed frontend/ directory (frontend not enabled)")
 
+# Remove middleware.ts if i18n is not enabled (Next.js requires middleware to export a function)
+if use_frontend and not enable_i18n:
+    middleware_file = os.path.join(os.getcwd(), "frontend", "src", "middleware.ts")
+    if os.path.exists(middleware_file):
+        os.remove(middleware_file)
+        print("Removed middleware.ts (i18n not enabled)")
+
 # Remove .env files if generate_env is false
 if not generate_env:
     backend_env = os.path.join(os.getcwd(), "backend", ".env")

{fastapi_fullstack-0.1.1 → fastapi_fullstack-0.1.3}/template/{{cookiecutter.project_slug}}/Makefile

@@ -4,7 +4,12 @@
 install:
 	uv sync --directory backend --dev
 {%- if cookiecutter.enable_precommit %}
-	uv run --directory backend pre-commit install
+	@if git rev-parse --git-dir > /dev/null 2>&1; then \
+		uv run --directory backend pre-commit install; \
+	else \
+		echo "⚠️  Not a git repository - skipping pre-commit install"; \
+		echo "   Run 'git init && make install' to set up pre-commit hooks"; \
+	fi
 {%- endif %}
 	@echo ""
 	@echo "✅ Installation complete!"