Skip to content

Create Framework Conversion Plan#59

Open
Giwan wants to merge 3 commits into
mainfrom
framework-conversion-plan-6131699963959772183
Open

Create Framework Conversion Plan#59
Giwan wants to merge 3 commits into
mainfrom
framework-conversion-plan-6131699963959772183

Conversation

@Giwan
Copy link
Copy Markdown
Owner

@Giwan Giwan commented Apr 6, 2026

The framework plan defines a centralized configuration schema for site metadata, navigation, feature flags, and themes. It also details the strategy for implementing dynamic routing to allow users to choose between a Blog or Tools landing page and describes the theme system using HSL variable overrides. A phased roadmap is provided to guide the systematic transformation of the repository into a forkable and customizable framework.


PR created automatically by Jules for task 6131699963959772183 started by @Giwan

This commit adds `FRAMEWORK_PLAN.md`, a comprehensive strategy for
transforming the current Astro-based blog into a reusable framework.
The plan covers:
- Centralized configuration system in `src/config.ts`
- Feature flags for Search, PWA, and Tools
- Multi-theme support with Tailwind v4 and HSL variable overrides
- Dynamic homepage selection (Blog vs. Tools)
- A four-phase implementation roadmap for systematic refactoring.

Co-authored-by: Giwan <1439004+Giwan@users.noreply.github.com>
@google-labs-jules
Copy link
Copy Markdown
Contributor

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

google-labs-jules Bot and others added 2 commits April 6, 2026 13:29
This commit adds `FRAMEWORK_PLAN.md`, a detailed architectural strategy
for transforming the repository into a reusable, forkable framework.
The plan features:
- Zod-based configuration schema for robust site settings.
- Feature toggle mechanism using Astro middleware and conditional rendering.
- Multi-theme system leveraging Tailwind v4 and dynamic HSL variable overrides.
- Configurable homepage landing (Blog or Tools).
- Asset management and a content bootstrapping strategy for new users.
- A four-phase roadmap for implementation and maintenance.

Co-authored-by: Giwan <1439004+Giwan@users.noreply.github.com>
- Introduced a centralized, Zod-validated configuration system in `src/config.ts`.
- Implemented a dynamic theming system (Newspaper, Minimal, Modern) using Tailwind v4 and HSL variables.
- Added feature flags for Search, PWA, Tools, and RSS with middleware-based route guarding.
- Refactored the homepage to be toggleable between Blog and Tools layouts.
- Created a `framework:clean` script to easily purge demo data for new projects.
- Documented an 'Expert AI Engineering Protocol' in `.idx/AGENTS.md` for framework maintenance.
- Ensured 100% test pass rate and verified build integrity.

Co-authored-by: Giwan <1439004+Giwan@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