Skip to content

refactor: simplify template structure and improve organization#398

Merged
davidpoblador merged 14 commits into
mainfrom
fix/simplify-template
Nov 8, 2025
Merged

refactor: simplify template structure and improve organization#398
davidpoblador merged 14 commits into
mainfrom
fix/simplify-template

Conversation

@davidpoblador

Copy link
Copy Markdown
Member

Summary

This PR refactors the repository structure to improve organization and simplify the template system:

Key Changes

  • Template Renaming: Renamed copier-template to vibetuner-template for better clarity and consistency
  • Documentation Separation: Moved documentation to dedicated vibetuner-docs component for better maintainability
  • Configuration Cleanup: Simplified root configuration files and removed unnecessary symlinks
  • Template Structure: Cleaned up template scaffolding and removed redundant files
  • Development Tooling: Updated development environment configurations and fixed linting issues
  • Dependency Updates: Bumped dependencies across all packages

Technical Improvements

  • Fixed import sorting issues in template files
  • Resolved djlint configuration and template formatting
  • Updated pre-commit hooks configuration
  • Improved VS Code workspace organization
  • Standardized file naming conventions

Breaking Changes

  • Template directory renamed from copier-template to vibetuner-template
  • Documentation moved to separate vibetuner-docs directory
  • Some unused CLI commands and hooks removed

Migration Notes

When upgrading, update any references to:

  • copier-template/vibetuner-template/
  • docs/vibetuner-docs/docs/

This refactor maintains full backward compatibility for generated projects while providing a cleaner, more maintainable template structure.

- Move mkdocs.yml and docs/ to vibetuner-docs/ directory
- Remove root pyproject.toml (no longer needed)
- Update CI workflow to use uvx and work from vibetuner-docs/
- Update justfile docs commands to use uvx
- Fix all references to old docs location in README and DEVELOPMENT.md
- Add vibetuner-docs to VS Code workspace
- Simplify docs setup by using uvx instead of dedicated Python environment
- Rename 'vibetuner-py' to 'Python Package'
- Rename 'vibetuner-js' to 'JavaScript Package'
- Rename 'vibetuner-docs' to 'Documentation'
- Rename copier-template/ directory to vibetuner-template/
- Update copier.yml _subdirectory reference
- Update justfile import path
- Update VS Code workspace name and path
- Update all documentation references
- Remove test_projects/ from .gitignore
- Fix hardcoded paths in help.md command
- Test scaffolding successfully works with new template location
- Update root symlinks to point to vibetuner-template/ instead of copier-template/
- Update llms*.txt symlinks to point to vibetuner-docs/docs/ instead of docs/
- All symlinks now correctly reference the new directory structure
- Remove uv.lock (not needed in root since docs moved to vibetuner-docs/)
- Remove test-commit-formats.md (development test file no longer needed)
- Remove llms.txt and llms-full.txt symlinks from root directory
- Files are properly located in vibetuner-docs/docs/ and referenced correctly by CI
- Eliminates duplicate access points and reduces root directory clutter
- Update root ty.toml exclude from 'template' to 'vibetuner-template'
- Remove redundant '**/.venv' exclude from vibetuner-template/ty.toml
- Ensures type checking works correctly with new directory structure
- Add root pyproject.toml with vibetuner-py path dependency
- Add uv.lock for reproducible development environment
- Enables pre-commit hooks and dev tools to run from root
- Maintains clean separation while allowing development workflows
@claude

claude Bot commented Nov 8, 2025

Copy link
Copy Markdown

Claude encountered an error —— View job


I'll analyze this and get back to you.

@davidpoblador davidpoblador merged commit 16f1b27 into main Nov 8, 2025
1 of 2 checks passed
@davidpoblador davidpoblador deleted the fix/simplify-template branch November 8, 2025 11:08
davidpoblador pushed a commit that referenced this pull request Nov 8, 2025
🤖 I have created a release *beep* *boop*
---


##
[2.16.0](v2.15.2...v2.16.0)
(2025-11-08)


### Features

* add .env.j2 template for scaffolded projects
([#395](#395))
([da335b5](da335b5))
* add mongo and redis services to compose.dev.yml
([#397](#397))
([9c299f9](9c299f9))
* integrate docs publishing into unified publish workflow
([#401](#401))
([e615b43](e615b43))


### Code Refactoring

* simplify template structure and improve organization
([#398](#398))
([16f1b27](16f1b27))


### Miscellaneous Chores

* **deps:** update mongo docker tag to v8.2
([#400](#400))
([f3c9f46](f3c9f46))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant