fastapi/full-stack-fastapi-template
72.2
Strong · 7 November 2026
7.7k
lines of production code
TypeScript
with Python
4
measurements over time
What this system is
Features
Added agent skills for FastAPI and SQLModel
The project now includes agent skills for the FastAPI and SQLModel libraries. Symlinks in both \.agents/skills\ and \.claude/skills\ directories point to the skill definitions provided by these packages, enabling AI agents to access library-specific guidance. A \library-skills\ tool skill is also added to help manage and discover skills bundled by installed packages.
.agents, .claude · high confidence
Removals
Removal of Couchbase-based backend implementation
The backend application code in \app/\ has been completely removed, eliminating the previous Couchbase-based implementation. This deletion includes the API router and endpoints for user, role, token, and utility management, as well as the underlying SQLAlchemy models, CRUD operations, and database session configuration. Supporting infrastructure such as the Celery worker setup, pre-start health checks, JWT authentication logic, password security utilities, and email templates (both MJML sources and built HTML) have also been removed, indicating a migration away from this specific technology stack.
_{{cookiecutter.project\slug}}/backend/app/app · high confidence
Removal of legacy Dockerfiles and .gitignore
The legacy Dockerfiles for the backend service, Celery worker, and tests, along with the .gitignore file, have been removed from the project. These files previously defined container builds based on Python 3.6 and specific package versions; their deletion indicates a shift away from this specific containerization setup.
_{{cookiecutter.project\slug}}/backend · high confidence
Removal of legacy Vue frontend codebase
The entire legacy Vue.js frontend application has been removed from the project. This includes all source code (components, views, store modules, API clients), configuration files (Vue CLI, Babel, Vuetify, VeeValidate), build assets (Dockerfile, public assets), and documentation. Users will no longer have access to this specific frontend implementation.
_{{cookiecutter.project\slug}}/frontend · high confidence
Removal of legacy linting script
The \lint.sh\ script, which previously executed autoflake, isort, and black to format the application code, has been removed from the backend scripts directory.
_{{cookiecutter.project\slug}}/backend/app/scripts · high confidence
Removed legacy Docker Compose build and deployment scripts
The shell scripts in the scripts directory (build-push.sh, build.sh, deploy.sh, test-local.sh, and test.sh) have been deleted. These scripts previously handled building Docker images, generating docker-stack.yml configurations, and deploying or testing the application via Docker Compose. Their removal indicates a shift away from this specific Docker Compose-based build and deployment workflow.
_{{cookiecutter.project\slug}}/scripts · high confidence
Behavioural changes
Admin route access restricted to superusers and dashboard displays logged-in user
The admin route now enforces superuser-only access by redirecting non-superusers to the home page, ensuring that only authorized administrators can manage user accounts. Additionally, the dashboard page has been updated to display a personalized greeting using the currently logged-in user's full name or email, improving the welcome experience for returning users.
_frontend/src/routes/\layout · high confidence
Alembic now reads database configuration from the centralized settings
The Alembic environment has been updated to retrieve the database connection URL directly from the application's centralized configuration settings (via \settings.DATABASE\_URL\) rather than relying on the \sqlalchemy.url\ value defined in the Alembic \.ini\ file. This ensures that database migrations consistently use the same connection parameters as the rest of the application, simplifying configuration management by removing the need to maintain separate database connection strings in the migration config.
backend/app/alembic · high confidence
Centralized API dependency injection and router configuration
The API layer now uses a dedicated dependency injection module (deps.py) to handle database sessions and JWT-based user authentication, replacing previous inline or scattered implementations. The main router (main.py) explicitly aggregates all route modules (login, users, utils, items) and conditionally includes the private router only in development environments, providing a clearer and more maintainable structure for API endpoint registration.
backend/app/api · high confidence
Core configuration and security infrastructure overhaul
The backend core module has been restructured to enforce stricter security and modernize dependencies. Configuration is now centralized in a Pydantic-based \Settings\ class that requires an explicit \SECRET\_KEY\ (rejecting the default 'changethis' value in production), uses a unified \DATABASE\_URL\ with automatic psycopg driver injection, and simplifies CORS by including the frontend host by default. Security has been upgraded by migrating from python-jose to PyJWT for token handling and adopting pwdlib with Argon2 as the default password hasher, while maintaining backward compatibility with existing Bcrypt hashes. Additionally, the codebase now uses \datetime.now(UTC)\ instead of the deprecated \utcnow()\ and enforces \EmailStr\ types for email fields.
backend/app/core · high confidence
Database schema modernization and security hardening
The backend database schema has been updated to use UUIDs instead of integer IDs for Users and Items, with a migration that preserves existing data. A new \created\_at\ timestamp field has been added to both models. To improve data integrity, string fields (email, name, title, description) now have explicit 255-character limits, and deleting a User will automatically cascade-delete their associated Items. Security has been strengthened by implementing constant-time password verification to prevent timing attacks during authentication.
backend/app · high confidence
Frontend architecture modernized with TanStack ecosystem and Tailwind CSS
The frontend application has been rebuilt using TanStack Router for file-based routing and TanStack Query for data fetching, replacing the previous implementation. The UI layer now utilizes Tailwind CSS with a comprehensive design system defined in index.css, supporting both light and dark themes via a ThemeProvider. Additionally, the entry point (main.tsx) now handles authentication errors by redirecting users to the login page on 401/403 responses, and TypeScript environment types are explicitly defined for Vite configuration.
frontend/src · high confidence
Frontend components migrated to Shadcn UI and TanStack Query
The frontend components in this area have been rewritten to use the Shadcn UI component library (imported from @/components/ui) and TanStack Query for data fetching and mutations, replacing the previous Chakra UI and React Query implementations. This change updates the visual design and interaction patterns for user and item management (Add, Edit, Delete dialogs and tables), as well as common layout elements like the sidebar, footer, and theme switcher, to align with the new Shadcn-based design system.
frontend/src/components · high confidence
Frontend rebuilt with Vite, React, TypeScript, and shadcn/ui
The frontend has been replaced with a modern stack using Vite, React, TypeScript, TanStack Router, TanStack Query, Tailwind CSS, and shadcn/ui. This change introduces Bun as the package manager, configures Biome for linting and formatting, and sets up Playwright for end-to-end testing. The build output is now served directly from the FastAPI backend, and the project structure has been simplified with path aliases and a new client generation setup via @hey-api/openapi-ts.
frontend · high confidence
Introduce release automation and update development scripts
The scripts directory now includes new automation tools for managing releases, specifically \prepare\_release.py\ which handles version bumping and release note extraction, and \add\_latest\_release\_date.py\ to ensure release headers contain dates. The \generate-client.sh\ script has been updated to regenerate the frontend client from the backend OpenAPI spec using Bun. Additionally, local and CI test scripts (\test-local.sh\, \test.sh\) have been refined to better manage Docker containers, and legacy cookiecutter-related scripts (\discard-dev-files.sh\, \generate\_cookiecutter\_config.py\) have been removed.
scripts · high confidence
Migrate frontend routing to TanStack Router with new auth flows
The frontend routing system has been replaced with TanStack Router, introducing a new root layout that integrates React Query and TanStack Router developer tools in development builds. Authentication pages (login, signup, recover-password, reset-password) now use file-based routing with built-in validation via Zod schemas and enforce access control through \beforeLoad\ guards that redirect unauthenticated users. The login form specifically requires a valid email address and a password of at least 8 characters, while the signup flow adds full name collection and password confirmation matching. Meta titles are now explicitly defined for each route to improve SEO and browser tab clarity.
frontend/src/routes · high confidence
Migrated frontend API client to @hey-api/openapi-ts
The frontend API client has been regenerated using the @hey-api/openapi-ts library instead of the previous openapi-typescript-codegen tool. This update refreshes the generated TypeScript types and service classes (such as UsersService and ItemsService) to align with the latest OpenAPI specification, ensuring improved type safety and consistency for all API interactions.
frontend/src/client · high confidence
New React-based email templates for account and password workflows
The system now uses React components (via react-email) to render transactional emails, replacing the previous static HTML approach. This change introduces new, styled templates for the 'new account' welcome email (displaying credentials and a dashboard link), the 'reset password' recovery email (with an expiration notice), and a 'test email' for verifying delivery configuration. These templates share a consistent visual identity, including a branded header, a callout section for details, and a standardized footer.
backend/app/email-templates, packages/react-email · high confidence
New authentication and utility hooks introduced
The frontend now includes a new \useAuth\ hook that manages user sessions, login, registration, and logout using TanStack Query and TanStack Router, replacing previous implementations. Additionally, new utility hooks have been added: \useCustomToast\ for displaying success and error notifications via Sonner, \useCopyToClipboard\ for handling clipboard operations, and \useIsMobile\ for detecting mobile viewports based on a 768px breakpoint.
frontend/src/hooks · high confidence
Removal of legacy Docker Compose and cookiecutter scaffolding
The project has discarded the cookiecutter-based generation approach in favor of a plain git clone/fork workflow. This change removes the \cookiecutter-config-file.yml\ and a large set of legacy Docker Compose files (including \docker-compose.\*.yml\ variants, \.env\, and shell scripts like \backend-start.sh\), effectively stripping out the previous multi-stage Docker build, Traefik v1 proxy, and Couchbase dependencies from this location.
_{{cookiecutter.project\slug}} · high confidence
Restructured API routes and introduced private user creation endpoint
The API route files have been moved from the nested \app/api/api\_v1\ directory to \app/api/routes\, updating the project's internal module structure. This change introduces a new private, local-only API endpoint (\/private/users/\) in \private.py\ designed for use in E2E tests to create users directly, bypassing standard registration flows. Additionally, the \users.py\ route now includes a \DELETE /me\ endpoint allowing non-superuser accounts to delete their own profiles, and the \items.py\ route enforces 403 Forbidden responses for users attempting to access items they do not own.
backend/app/api/routes · high confidence
Rework backend script structure and tooling
The backend scripts have been reorganized into a dedicated \backend/scripts\ directory, replacing the previous layout. The new structure introduces specific shell scripts for formatting (\format.sh\), linting (\lint.sh\), pre-start initialization (\prestart.sh\), and testing (\test.sh\). Formatting and linting now utilize \ruff\ and \ty\ instead of previous tools, while the test script integrates \coverage\ reporting. The pre-start script handles database migrations and initial data population, and the test runner has been consolidated to use the new \test.sh\ entry point.
backend/scripts · high confidence
Simplify Docker Compose deployment and local development workflow
The project now uses a simplified Docker Compose setup with three distinct files: \compose.yml\ for the shared stack, \compose.override.yml\ for local development settings (including hot-reload and local service ports), and \compose.deploy.yml\ for production deployment with HTTPS via Traefik. Local development now uses Mailpit instead of Mailcatcher for email testing, and the backend serves the frontend directly from FastAPI. The \.env\ file provides sensible defaults for local development, and the \development.md\ guide has been updated to reflect the new workflow, including instructions for running the full stack with \docker compose watch\.
(repo-wide) · high confidence
Fixes
Fix Windows line endings in generated shell scripts
The project generation hook now automatically converts Windows-style CRLF line endings to Unix-style LF endings for all generated shell scripts. This ensures that shell scripts run correctly on Unix-like systems without requiring manual line-ending fixes.
hooks · high confidence
Test coverage
Added backend API and CRUD test suites; Initial Playwright end-to-end test suite for frontend; New test utilities for E2E user flows and email verification.
Dependencies
Migrate project to uv workspaces and Bun with updated dependencies
The project has replaced its legacy package management and build tooling with a modern stack. The backend now uses \uv\ for dependency management (defined in \pyproject.toml\) instead of the old \Pipfile\/\Pipfile.lock\ setup, and requires Python 3.14. The frontend has migrated from npm/Vue CLI to a Bun-based monorepo structure using \package.json\ workspaces, replacing the previous \package-lock.json\ and Vue 2 dependencies with React 19, Vite 8, and TanStack Router. This change introduces \uv\ workspaces at the root level to coordinate the backend and frontend packages.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 69 → 72 (+3.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 75 → 75 (+0.0)
- Architecture 98 → 98 (+0.0)
- Maturity 64 → 71 (+6.9)
- Readiness 72 → 70 (-1.4)
- Security 71 → 74 (+3.0)
- Accessibility 71 → 71 (+0.0)
- Performance 100 → 100 (+0.0)
Resolved (4)
- Critical vulnerability: [GHSA redacted] (uv.lock)
- Critical vulnerability: [GHSA redacted] (bun.lock)
- High CVE: [GHSA redacted] (bun.lock)
- Off-boarding risk: anonymized user #1
New (6)
- High CVE: [CVE redacted] (bun.lock)
- Low CVE: [GHSA redacted] (bun.lock)
- Medium CVE: [GHSA redacted] (bun.lock)
- Medium CVE: [GHSA redacted] (bun.lock)
- Medium CVE: [GHSA redacted] (bun.lock)
- Off-boarding risk: anonymized user #1
Changes since last survey
- 12 commits — 12 feature/other, 0 fixes
By area
- (root) — 11 commits
- .github/workflows — 1 commit
Notable commits
- change: ⬆ Bump certifi from 2026.6.17 to 2026.10.19 (#2518)
- change: ⬆ Bump dnspython from 2.8.0 to 2.9.0 (#2524)
- change: ⬆ Bump playwright from v1.63.0-noble to v1.64.1-noble in /frontend in the docker group across 1 directory (#2521)
- change: ⬆ Bump pre-commit hooks (#2523)
- change: ⬆ Bump the github-actions group with 6 updates (#2520)
- change: ⬆ Bump the npm-packages group across 1 directory with 30 updates (#2525)
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
fastapi/full-stack-fastapi-template was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 7 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit aabb90126964a164e02aff39e7c385bb0598236d — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-110e4fee044f.