create-flask-react 0.1.0__tar.gz

create_flask_react-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joseph McGill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

create_flask_react-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: create-flask-react
+Version: 0.1.0
+Summary: Scaffold a full-stack Flask + React starter project with auth, PostgreSQL, and Docker
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/jsphfrntz/create-flask-react
+Project-URL: Repository, https://github.com/jsphfrntz/create-flask-react
+Project-URL: Issues, https://github.com/jsphfrntz/create-flask-react/issues
+Keywords: flask,react,starter,scaffold,docker,fullstack
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Framework :: Flask
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# create-flask-react
+
+Scaffold a full-stack Flask + React starter project with auth, PostgreSQL, and Docker.
+
+## Quick Start
+
+```bash
+uvx create-flask-react my-app
+cd my-app
+make dev
+```
+
+Then open http://localhost:5173 — you'll see a login page, register an account, and land on an authenticated dashboard.
+
+## What You Get
+
+- **Backend:** Flask with Flask-RESTX (auto-generated Swagger docs at `/api/docs`)
+- **Auth:** Flask-Login with session-based authentication
+- **Database:** PostgreSQL with Flask-SQLAlchemy + Flask-Migrate
+- **Frontend:** React 18 + TypeScript + Vite
+- **UI:** Tailwind CSS + shadcn/ui components
+- **Docker:** Single `docker compose up` for the full stack
+
+## Project Structure
+
+```
+my-app/
+├── docker-compose.yml          # Dev: Flask + Vite + Postgres
+├── Makefile                    # Convenience commands
+├── backend/
+│   ├── app/
+│   │   ├── __init__.py         # App factory
+│   │   ├── config.py           # Config from env vars
+│   │   ├── extensions.py       # SQLAlchemy, Migrate, LoginManager
+│   │   ├── models/user.py      # User model
+│   │   └── routes/auth.py      # Auth API (Flask-RESTX)
+│   ├── migrations/             # Alembic migrations
+│   └── pyproject.toml          # Python deps (managed by uv)
+└── frontend/
+    └── src/
+        ├── api/client.ts       # Typed API client
+        ├── context/AuthContext  # Auth state management
+        ├── components/ui/      # shadcn/ui components
+        └── pages/              # Login, Register, Dashboard
+```
+
+## Make Targets
+
+| Command | Description |
+|---------|-------------|
+| `make dev` | Start dev environment |
+| `make stop` | Stop containers |
+| `make logs` | Tail container logs |
+| `make db-migrate` | Generate a new migration |
+| `make db-upgrade` | Apply migrations |
+| `make shell` | Flask shell |
+| `make clean` | Stop containers and remove volumes |
+
+## API Docs
+
+Swagger UI is available at http://localhost:5000/api/docs when the backend is running.
+
+## License
+
+MIT

create_flask_react-0.1.0/README.md

@@ -0,0 +1,65 @@
+# create-flask-react
+
+Scaffold a full-stack Flask + React starter project with auth, PostgreSQL, and Docker.
+
+## Quick Start
+
+```bash
+uvx create-flask-react my-app
+cd my-app
+make dev
+```
+
+Then open http://localhost:5173 — you'll see a login page, register an account, and land on an authenticated dashboard.
+
+## What You Get
+
+- **Backend:** Flask with Flask-RESTX (auto-generated Swagger docs at `/api/docs`)
+- **Auth:** Flask-Login with session-based authentication
+- **Database:** PostgreSQL with Flask-SQLAlchemy + Flask-Migrate
+- **Frontend:** React 18 + TypeScript + Vite
+- **UI:** Tailwind CSS + shadcn/ui components
+- **Docker:** Single `docker compose up` for the full stack
+
+## Project Structure
+
+```
+my-app/
+├── docker-compose.yml          # Dev: Flask + Vite + Postgres
+├── Makefile                    # Convenience commands
+├── backend/
+│   ├── app/
+│   │   ├── __init__.py         # App factory
+│   │   ├── config.py           # Config from env vars
+│   │   ├── extensions.py       # SQLAlchemy, Migrate, LoginManager
+│   │   ├── models/user.py      # User model
+│   │   └── routes/auth.py      # Auth API (Flask-RESTX)
+│   ├── migrations/             # Alembic migrations
+│   └── pyproject.toml          # Python deps (managed by uv)
+└── frontend/
+    └── src/
+        ├── api/client.ts       # Typed API client
+        ├── context/AuthContext  # Auth state management
+        ├── components/ui/      # shadcn/ui components
+        └── pages/              # Login, Register, Dashboard
+```
+
+## Make Targets
+
+| Command | Description |
+|---------|-------------|
+| `make dev` | Start dev environment |
+| `make stop` | Stop containers |
+| `make logs` | Tail container logs |
+| `make db-migrate` | Generate a new migration |
+| `make db-upgrade` | Apply migrations |
+| `make shell` | Flask shell |
+| `make clean` | Stop containers and remove volumes |
+
+## API Docs
+
+Swagger UI is available at http://localhost:5000/api/docs when the backend is running.
+
+## License
+
+MIT

create_flask_react-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "create-flask-react"
+version = "0.1.0"
+description = "Scaffold a full-stack Flask + React starter project with auth, PostgreSQL, and Docker"
+requires-python = ">=3.10"
+license = "MIT"
+readme = "README.md"
+keywords = ["flask", "react", "starter", "scaffold", "docker", "fullstack"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Code Generators",
+    "Framework :: Flask",
+]
+
+[project.urls]
+Homepage = "https://github.com/jsphfrntz/create-flask-react"
+Repository = "https://github.com/jsphfrntz/create-flask-react"
+Issues = "https://github.com/jsphfrntz/create-flask-react/issues"
+
+[project.scripts]
+create-flask-react = "create_flask_react.main:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+create_flask_react = [
+    "template/**/*",
+    "template/**/.gitkeep",
+    "template/**/.gitignore",
+    "template/**/.dockerignore",
+    "template/.env.example",
+]

create_flask_react-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

create_flask_react-0.1.0/src/create_flask_react/main.py

@@ -0,0 +1,50 @@
+"""CLI entry point for create-flask-react."""
+
+import argparse
+import shutil
+import sys
+from pathlib import Path
+
+TEMPLATE_DIR = Path(__file__).parent / "template"
+IGNORE = shutil.ignore_patterns(
+    ".venv", "node_modules", "__pycache__", "*.pyc", ".env",
+)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Create a new Flask + React project"
+    )
+    parser.add_argument(
+        "project_name",
+        help="Name of the project directory to create (use '.' for current directory)",
+    )
+    args = parser.parse_args()
+
+    if args.project_name == ".":
+        dest = Path.cwd()
+    else:
+        dest = Path.cwd() / args.project_name
+
+    if dest.exists() and args.project_name != ".":
+        if any(dest.iterdir()):
+            print(f"Error: {dest} already exists and is not empty.", file=sys.stderr)
+            sys.exit(1)
+
+    dest.mkdir(parents=True, exist_ok=True)
+
+    shutil.copytree(TEMPLATE_DIR, dest, dirs_exist_ok=True, ignore=IGNORE)
+
+    # Create .env from .env.example
+    env_example = dest / ".env.example"
+    env_file = dest / ".env"
+    if env_example.exists() and not env_file.exists():
+        shutil.copy2(env_example, env_file)
+
+    print(f"Created Flask + React project in {dest.resolve()}")
+    print()
+    print("Next steps:")
+    print(f"  cd {args.project_name}")
+    print("  make dev")
+    print()
+    print("Then open http://localhost:5173 in your browser.")

create_flask_react-0.1.0/src/create_flask_react/template/.env.example

@@ -0,0 +1,10 @@
+# Database
+POSTGRES_USER=app
+POSTGRES_PASSWORD=changeme
+POSTGRES_DB=app
+DATABASE_URL=postgresql://app:changeme@db:5432/app
+
+# Flask
+SECRET_KEY=change-this-to-a-random-secret
+FLASK_ENV=development
+FLASK_DEBUG=1

create_flask_react-0.1.0/src/create_flask_react/template/.gitignore

@@ -0,0 +1,23 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+
+# Node
+node_modules/
+dist/
+
+# Environment
+.env
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+*.log

create_flask_react-0.1.0/src/create_flask_react/template/Makefile

@@ -0,0 +1,22 @@
+.PHONY: dev stop logs db-migrate db-upgrade shell clean
+
+dev:
+	docker compose up --build
+
+stop:
+	docker compose down
+
+logs:
+	docker compose logs -f
+
+db-migrate:
+	docker compose exec backend uv run flask db migrate
+
+db-upgrade:
+	docker compose exec backend uv run flask db upgrade
+
+shell:
+	docker compose exec backend uv run flask shell
+
+clean:
+	docker compose down -v

create_flask_react-0.1.0/src/create_flask_react/template/backend/.dockerignore

@@ -0,0 +1,3 @@
+.venv
+__pycache__
+*.pyc

create_flask_react-0.1.0/src/create_flask_react/template/backend/Dockerfile

@@ -0,0 +1,6 @@
+FROM python:3.12-slim
+WORKDIR /app
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+COPY pyproject.toml uv.lock* ./
+RUN uv sync
+COPY . .

create_flask_react-0.1.0/src/create_flask_react/template/backend/app/__init__.py

@@ -0,0 +1,23 @@
+import os
+from flask import Flask
+from .config import config
+from .extensions import db, migrate, login_manager
+
+
+def create_app():
+    app = Flask(__name__, static_folder="static", static_url_path="/")
+
+    env = os.getenv("FLASK_ENV", "development")
+    app.config.from_object(config[env])
+
+    db.init_app(app)
+    migrate.init_app(app, db)
+    login_manager.init_app(app)
+
+    from .routes import api_bp
+    from .routes.main import main_bp
+
+    app.register_blueprint(api_bp)
+    app.register_blueprint(main_bp)
+
+    return app

create_flask_react-0.1.0/src/create_flask_react/template/backend/app/config.py

@@ -0,0 +1,29 @@
+import os
+
+
+class BaseConfig:
+    SECRET_KEY = os.getenv("SECRET_KEY", "change-this-to-a-random-secret")
+    SQLALCHEMY_DATABASE_URI = os.getenv("DATABASE_URL")
+    SQLALCHEMY_TRACK_MODIFICATIONS = False
+    SESSION_COOKIE_SAMESITE = "Lax"
+    SESSION_COOKIE_HTTPONLY = True
+
+
+class DevelopmentConfig(BaseConfig):
+    DEBUG = True
+
+
+class ProductionConfig(BaseConfig):
+    DEBUG = False
+
+
+class TestConfig(BaseConfig):
+    TESTING = True
+    SQLALCHEMY_DATABASE_URI = "sqlite:///:memory:"
+
+
+config = {
+    "development": DevelopmentConfig,
+    "production": ProductionConfig,
+    "testing": TestConfig,
+}

create_flask_react-0.1.0/src/create_flask_react/template/backend/app/extensions.py

@@ -0,0 +1,19 @@
+from flask import jsonify
+from flask_login import LoginManager
+from flask_migrate import Migrate
+from flask_sqlalchemy import SQLAlchemy
+
+db = SQLAlchemy()
+migrate = Migrate()
+login_manager = LoginManager()
+
+
+@login_manager.user_loader
+def load_user(user_id):
+    from .models.user import User
+    return db.session.get(User, int(user_id))
+
+
+@login_manager.unauthorized_handler
+def unauthorized():
+    return jsonify({"error": "Authentication required"}), 401

create_flask_react-0.1.0/src/create_flask_react/template/backend/app/models/__init__.py

@@ -0,0 +1,3 @@
+from .user import User
+
+__all__ = ["User"]

create_flask_react-0.1.0/src/create_flask_react/template/backend/app/models/user.py

@@ -0,0 +1,18 @@
+from datetime import datetime, timezone
+from flask_login import UserMixin
+from werkzeug.security import generate_password_hash, check_password_hash
+from ..extensions import db
+
+
+class User(UserMixin, db.Model):
+    id = db.Column(db.Integer, primary_key=True)
+    email = db.Column(db.String(255), unique=True, nullable=False, index=True)
+    password_hash = db.Column(db.String(256), nullable=False)
+    is_active = db.Column(db.Boolean, default=True)
+    created_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc))
+
+    def set_password(self, password):
+        self.password_hash = generate_password_hash(password)
+
+    def check_password(self, password):
+        return check_password_hash(self.password_hash, password)

create_flask_react-0.1.0/src/create_flask_react/template/backend/app/routes/__init__.py

@@ -0,0 +1,16 @@
+from flask import Blueprint
+from flask_restx import Api
+
+api_bp = Blueprint("api", __name__, url_prefix="/api")
+
+api = Api(
+    api_bp,
+    version="1.0",
+    title="API",
+    description="Flask + React Starter API",
+    doc="/docs",
+)
+
+from .auth import ns as auth_ns  # noqa: E402
+
+api.add_namespace(auth_ns)

create_flask_react-0.1.0/src/create_flask_react/template/backend/app/routes/auth.py

@@ -0,0 +1,107 @@
+from flask_login import current_user, login_required, login_user, logout_user
+from flask_restx import Namespace, Resource, fields
+from ..extensions import db
+from ..models.user import User
+
+ns = Namespace("auth", description="Authentication")
+
+credentials_model = ns.model("Credentials", {
+    "email": fields.String(required=True, description="User email"),
+    "password": fields.String(required=True, description="User password"),
+})
+
+user_model = ns.model("User", {
+    "id": fields.Integer(description="User ID"),
+    "email": fields.String(description="User email"),
+    "created_at": fields.DateTime(description="Account creation date"),
+})
+
+error_model = ns.model("Error", {
+    "error": fields.String(description="Error message"),
+})
+
+message_model = ns.model("Message", {
+    "message": fields.String(description="Status message"),
+})
+
+
+@ns.route("/register")
+class Register(Resource):
+    @ns.expect(credentials_model)
+    @ns.response(201, "User created", user_model)
+    @ns.response(400, "Validation error", error_model)
+    @ns.response(409, "Email already registered", error_model)
+    def post(self):
+        """Register a new user."""
+        data = ns.payload
+        email = data.get("email")
+        password = data.get("password")
+
+        if not email or not password:
+            return {"error": "Email and password are required"}, 400
+
+        if User.query.filter_by(email=email).first():
+            return {"error": "Email already registered"}, 409
+
+        user = User(email=email)
+        user.set_password(password)
+        db.session.add(user)
+        db.session.commit()
+
+        login_user(user)
+
+        return {
+            "id": user.id,
+            "email": user.email,
+            "created_at": user.created_at.isoformat(),
+        }, 201
+
+
+@ns.route("/login")
+class Login(Resource):
+    @ns.expect(credentials_model)
+    @ns.response(200, "Login successful", user_model)
+    @ns.response(401, "Invalid credentials", error_model)
+    def post(self):
+        """Log in with email and password."""
+        data = ns.payload
+        email = data.get("email")
+        password = data.get("password")
+
+        user = User.query.filter_by(email=email).first()
+
+        if user is None or not user.check_password(password):
+            return {"error": "Invalid email or password"}, 401
+
+        login_user(user)
+
+        return {
+            "id": user.id,
+            "email": user.email,
+            "created_at": user.created_at.isoformat(),
+        }, 200
+
+
+@ns.route("/logout")
+class Logout(Resource):
+    @login_required
+    @ns.response(200, "Logged out", message_model)
+    @ns.response(401, "Not authenticated", error_model)
+    def post(self):
+        """Log out the current user."""
+        logout_user()
+        return {"message": "Logged out"}, 200
+
+
+@ns.route("/me")
+class Me(Resource):
+    @login_required
+    @ns.response(200, "Current user", user_model)
+    @ns.response(401, "Not authenticated", error_model)
+    def get(self):
+        """Get the current authenticated user."""
+        return {
+            "id": current_user.id,
+            "email": current_user.email,
+            "created_at": current_user.created_at.isoformat(),
+        }, 200

create_flask_react-0.1.0/src/create_flask_react/template/backend/app/routes/main.py

@@ -0,0 +1,19 @@
+import os
+from flask import Blueprint, send_from_directory, current_app
+
+main_bp = Blueprint("main", __name__)
+
+
+@main_bp.route("/", defaults={"path": ""})
+@main_bp.route("/<path:path>")
+def serve(path):
+    static_folder = os.path.join(current_app.root_path, "static")
+
+    if path and os.path.exists(os.path.join(static_folder, path)):
+        return send_from_directory(static_folder, path)
+
+    index_path = os.path.join(static_folder, "index.html")
+    if os.path.exists(index_path):
+        return send_from_directory(static_folder, "index.html")
+
+    return "Frontend not built. Run the Vite dev server or build the frontend.", 404

create_flask_react-0.1.0/src/create_flask_react/template/backend/migrations/README

@@ -0,0 +1 @@
+Single-database configuration for Flask.

create_flask_react-0.1.0/src/create_flask_react/template/backend/migrations/alembic.ini

@@ -0,0 +1,40 @@
+[alembic]
+
+[loggers]
+keys = root,sqlalchemy,alembic,flask_migrate
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[logger_flask_migrate]
+level = INFO
+handlers =
+qualname = flask_migrate
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S