From 2e3980bc55befb3c2d5d94f8ffea3609aaf6c546 Mon Sep 17 00:00:00 2001 From: Zubair Qazi Date: Thu, 1 Oct 2026 16:02:31 -0400 Subject: [PATCH] Teach the big aid programs, and flag every school's own guarantee The Financial Aid Overview gains a "Know your aid" block above the checklist: the big programs (Pell, QuestBridge, ROTC, the GI Bill), state grants with the student's own state first, the school's own aid application, and the five kinds of scholarships. Each row is colour-coded by where the money comes from and ends with what Edvifi can do about it. More and more colleges promise free tuition below a family income, but only to students who finish that school's aid steps on time. Forty of them, checked against each school's own site, now live on the colleges table, the only source. Deadlines badges them, residency included, and Application Tracking turns each into a task, adding the CSS Profile to public schools whose guarantee runs through it. The migration has to be applied before this deploys: the aid queries select its new columns. Scholarships is renamed My Scholarships. The deadline rail beside each module's Overview now collapses like the dashboard's, sharing its state and its toggle, and scrollbars are thin and quiet instead of the platform default. --- supabase/README.md | 1 + .../20260930000000_college_aid_guarantees.sql | 290 ++++++++++++++++++ web/src/components/AidGuideSections.tsx | 268 ++++++++++++++++ .../components/CollegeDiscoverTab.test.tsx | 1 + web/src/components/Dashboard.tsx | 29 +- web/src/components/DeadlinePanel.test.tsx | 4 +- web/src/components/FafsaModuleTour.tsx | 2 +- web/src/components/FinancialAidModule.tsx | 140 ++++++--- web/src/components/ModuleOverviewTab.tsx | 2 +- web/src/components/ModuleShell.tsx | 2 +- web/src/components/OverviewRail.tsx | 50 +++ web/src/contexts/ApplicationsContext.tsx | 45 ++- web/src/data/aidPrograms.test.ts | 25 ++ web/src/data/aidPrograms.ts | 190 ++++++++++++ web/src/data/applicationDeadlines.ts | 6 +- web/src/data/applicationTasks.test.ts | 62 +++- web/src/data/applicationTasks.ts | 84 ++++- web/src/data/applicationsChecklist.ts | 5 + web/src/data/checklistContent.ts | 2 +- web/src/index.css | 88 +++++- web/src/lib/aidColleges.test.ts | 28 +- web/src/lib/aidColleges.ts | 81 ++++- web/src/lib/collegeMatch.test.ts | 1 + web/src/lib/useAidColleges.ts | 11 +- web/src/types/database.ts | 21 ++ 25 files changed, 1362 insertions(+), 76 deletions(-) create mode 100644 supabase/migrations/20260930000000_college_aid_guarantees.sql create mode 100644 web/src/components/AidGuideSections.tsx create mode 100644 web/src/components/OverviewRail.tsx create mode 100644 web/src/data/aidPrograms.test.ts create mode 100644 web/src/data/aidPrograms.ts diff --git a/supabase/README.md b/supabase/README.md index d8eb45e..799c445 100644 --- a/supabase/README.md +++ b/supabase/README.md @@ -24,6 +24,7 @@ The full schema history for the project, in apply order: | `20260715010000_college_ingest_runs` | `college_ingest_runs` audit log for the Scorecard ingest. | | `20260717000000_college_student_body` | Adds `student_body` jsonb (diversity / retention / women / first-gen) to `colleges` for the Discover detail popup. | | `20260915000000_remove_paid_and_political_scholarships` | Archives nine curated scholarships: six that charge an application/entry fee, three political-advocacy essay contests. See `seed.sql`'s curation rules. | +| `20260930000000_college_aid_guarantees` | Adds `aid_guarantee*` columns to `colleges` (with a CHECK that the four text fields come together) and backfills 40 schools' income guarantees across 54 campus rows (Harvard, Go Blue Guarantee, Blue and Gold, …), checked 2026-09-30. The only source for guarantees; correct one with a new migration. | ### Notes diff --git a/supabase/migrations/20260930000000_college_aid_guarantees.sql b/supabase/migrations/20260930000000_college_aid_guarantees.sql new file mode 100644 index 0000000..c03cc98 --- /dev/null +++ b/supabase/migrations/20260930000000_college_aid_guarantees.sql @@ -0,0 +1,290 @@ +-- Income guarantees from each school's own financial aid program. +-- +-- A growing number of colleges promise free tuition (sometimes the full cost) +-- below a family income: Harvard under $200,000, Michigan's Go Blue Guarantee, +-- UC's Blue and Gold plan. Every one of them depends on the student finishing +-- that school's aid steps on time, so the app shows the guarantee next to the +-- school and turns it into a task on the school's application page. +-- +-- No public dataset carries these. The College Scorecard has nothing on them +-- and neither does the Common Data Set, so each row below was read off the +-- school's own site and checked on 2026-09-30. Which schools need the CSS +-- Profile was checked against College Board's 2027–28 participating list. +-- Thresholds that change for students entering in fall 2027 carry the fall 2027 +-- figure: that is this year's seniors. +-- +-- One guarantee per school, so plain columns rather than a side table. All are +-- null for a school without one, and null means "none we know of", never "this +-- school offers nothing". +-- +-- From here on this table is the only source: the app reads guarantees from it +-- (and copies the short form onto each saved school for its task list). To +-- change one, write a new migration with the corrected row and checked date. + +alter table public.colleges + add column if not exists aid_guarantee text, + add column if not exists aid_guarantee_residents text, + add column if not exists aid_guarantee_needs_css boolean, + add column if not exists aid_guarantee_detail text, + add column if not exists aid_guarantee_action text, + add column if not exists aid_guarantee_url text, + add column if not exists aid_guarantee_checked_on date; + +comment on column public.colleges.aid_guarantee is + 'Name or one-line summary of the school''s income guarantee (e.g. ''Go Blue Guarantee''). Null means none we know of.'; +comment on column public.colleges.aid_guarantee_residents is + 'Who the guarantee is limited to (e.g. ''Michigan residents''). Null when it is open to every U.S. student.'; +comment on column public.colleges.aid_guarantee_needs_css is + 'True when getting the guarantee takes the CSS Profile. Drives the CSS task on public schools, which otherwise only private ones get.'; +comment on column public.colleges.aid_guarantee_detail is + 'Who qualifies and what is covered, in plain language.'; +comment on column public.colleges.aid_guarantee_action is + 'What the student must file, and by when, to get it.'; +comment on column public.colleges.aid_guarantee_url is + 'The school''s own page for the guarantee. The source for the row.'; +comment on column public.colleges.aid_guarantee_checked_on is + 'When the row was last checked against aid_guarantee_url. These change most years.'; + +-- Backfill. Keyed on scorecard_id. Rows were found by website domain and then +-- checked by hand: satellite campuses a program covers are in (all six Ohio +-- State campuses, Emory's Oxford College), while graduate schools and online +-- divisions that share a parent's domain are out (Teachers College, Weill +-- Cornell, Texas A&M Health Science Center, UF Online, Notre Dame's second +-- non-degree row). +with guarantees(scorecard_id, aid_guarantee, aid_guarantee_residents, aid_guarantee_needs_css, + aid_guarantee_detail, aid_guarantee_action, aid_guarantee_url) as (values + (166027, 'Free tuition under $200K', null, true, + 'Tuition is covered for families earning $200,000 or less. Under $100,000, families pay nothing at all.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://college.harvard.edu/financial-aid'), + (166683, 'Free tuition under $200K', null, true, + 'Tuition is covered for families earning under $200,000. Under $100,000, families pay nothing at all.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://news.mit.edu/2024/mit-tuition-undergraduates-family-income-1120'), + (186131, 'Free tuition under $250K', null, false, + 'Most families earning up to $250,000 pay no tuition. Up to $150,000, most pay nothing at all.', + 'File the FAFSA and Princeton’s own financial aid application.', + 'https://www.princeton.edu/news/2025/08/07/princeton-enhances-financial-aid-again-it-welcomes-class-2029-which-includes'), + (130794, 'Free tuition under $200K', null, true, + 'From 2026–27, tuition is covered for families earning under $200,000. Under $100,000, families pay nothing at all.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://news.yale.edu/2026/01/27/yale-offer-free-tuition-families-incomes-below-200000'), + (215062, 'Quaker Commitment', null, true, + 'Full tuition for most families earning up to $200,000. Under $75,000, most get the full cost covered.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://www.upenn.edu/pennforward/penn-quaker-commitment'), + (190150, 'Free tuition under $150K', null, true, + 'Columbia College and Columbia Engineering are tuition-free for families earning under $150,000. Under $66,000, parents pay nothing.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://cc-seas.financialaid.columbia.edu/how/aid/works'), + (217156, 'Free tuition under $125K', null, true, + 'Full tuition is covered for families earning $125,000 or less. Under $60,000, all direct costs are covered.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://www.brown.edu/news/2026-02-09/fy27-tuition-fees-salaries'), + (182670, 'Free tuition under $175K', null, true, + 'Families earning under $125,000 pay no parent contribution. From $125,000 to $175,000, tuition is covered.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://financialaid.dartmouth.edu/how-aid-works/how-much-help-will-i-get'), + (190415, 'Free tuition under $125K', null, true, + 'Tuition is covered for families earning up to $125,000. Up to $75,000, the full cost is covered.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://news.cornell.edu/stories/2026/03/board-trustees-approves-2026-27-budget-parameters'), + (243744, 'Free tuition under $150K', null, true, + 'Tuition is free for families earning under $150,000. Under $100,000, tuition, housing and food are free.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://admission.stanford.edu/afford/'), + (110404, 'Free tuition under $200K', null, true, + 'Tuition is covered for families earning under $200,000. Under $100,000, the full cost is covered.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://www.finaid.caltech.edu/'), + (162928, 'Free tuition under $200K', null, true, + 'From 2026–27, tuition is free for families earning up to $200,000. Up to $100,000, families pay nothing.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://sfs.jhu.edu/tuition-promise/'), + (147767, 'Pay nothing under $70K', null, true, + 'Most families earning under $70,000 attend at no cost. Northwestern is fundraising to make it tuition-free under $150,000, but that is a goal, not yet a promise.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://undergradaid.northwestern.edu/'), + (144050, 'Free tuition under $250K', null, false, + 'For students starting in fall 2027, tuition is free for families earning up to $250,000. Up to $125,000, tuition, housing, meals and fees are covered.', + 'File the FAFSA and the school’s required aid forms by its deadline. Its aid page lists them.', + 'https://www.uchicago.edu/admissions/affordability'), + (221999, 'Free tuition under $200K', null, true, + 'Opportunity Vanderbilt covers full tuition for families earning $200,000 or less, starting with students who enter in fall 2027.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://admissions.vanderbilt.edu/affordability/opportunity-vanderbilt/'), + (227757, 'Free tuition under $200K', null, true, + 'For students entering in fall 2027, tuition is free for families earning up to $200,000. Under $100,000, tuition, fees, housing and food are covered.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://financialaid.rice.edu/rice-investment'), + (487092, 'Free tuition under $200K', null, true, + 'From fall 2026, Emory Advantage Plus makes Emory tuition-free for U.S. students from families earning $200,000 or less.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://studentaid.emory.edu/undergraduate/types/grants-scholarships/emory-grants/emory-advantage.html'), + (139658, 'Free tuition under $200K', null, true, + 'From fall 2026, Emory Advantage Plus makes Emory tuition-free for U.S. students from families earning $200,000 or less.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://studentaid.emory.edu/undergraduate/types/grants-scholarships/emory-grants/emory-advantage.html'), + (168148, 'Free tuition under $150K', null, true, + 'From fall 2026, the Tufts Tuition Pact makes Tufts tuition-free for U.S. families earning less than $150,000.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://now.tufts.edu/2025/09/09/tufts-will-be-tuition-free-us-families-earning-less-150000'), + (152080, 'Free tuition under $150K', null, true, + 'From 2026–27, tuition is covered for families earning under $150,000, and half of tuition under $200,000.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://financialaid.nd.edu/costs-and-affordability/'), + (164988, 'BU Promise', null, true, + 'From 2026–27, full tuition is covered for families earning under $200,000, with the parent share capped at $20,000 a year. Families earning $75,000 or less pay nothing.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://www.bu.edu/articles/2026/new-financial-aid-program-covers-tuition-for-certain-families/'), + (123961, 'Free tuition under $80K', null, true, + 'Tuition is free for students who start as first-years from families earning $80,000 or less.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://affordability.usc.edu/'), + (190099, 'Free tuition under $175K', null, true, + 'From fall 2026, the Colgate Commitment makes tuition free for families earning up to $175,000, with no loans up to $200,000.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://www.colgate.edu/admission-aid/financial-aid/colgate-commitment'), + (234207, 'Free tuition under $200K', null, true, + 'The W&L Promise makes tuition free for families earning under $200,000, starting with students who enter in fall 2027. Under $75,000, housing and food are covered too.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://www.wlu.edu/admissions/financial-aid/the-w-l-promise'), + (164465, 'Free tuition under $141K', null, true, + 'Most students from families earning under $141,000 receive a scholarship covering tuition. Under $67,500, most get tuition, housing and meals covered.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://www.amherst.edu/admission/financial_aid'), + (198419, 'Free tuition under $150K', 'North and South Carolina residents', true, + 'Full tuition for North and South Carolina residents from families earning $150,000 or less. Up to $65,000, housing and meals are covered too.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://financialaid.duke.edu/initiative-students-carolinas/'), + (199847, 'Free tuition under $200K', 'North Carolina residents', true, + 'From fall 2026, North Carolina students from families earning $200,000 or less attend tuition-free. At $100,000 or less, housing and food are covered too. From $200,001 to $300,000, half of tuition is covered.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://financialaid.wfu.edu/types-of-aid/ncgateway-to-wfu/'), + (179867, 'WashU Pledge', 'Missouri and southern Illinois students', true, + 'Tuition, fees, housing and food for first-year students from Missouri and southern Illinois whose families earn $75,000 or less.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://financialaid.washu.edu/how-washu-helps/washu-pledge/'), + (170976, 'Go Blue Guarantee', 'Michigan residents', true, + 'Free tuition for Michigan residents with family income and assets of $125,000 or less.', + 'No separate application, but file the FAFSA and the CSS Profile by March 31.', + 'https://finaid.umich.edu/apply-aid/new-undergraduates/michigan-residents/go-blue-guarantee-eligibility'), + (110635, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (110662, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (110680, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (110653, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (110644, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (110705, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (110714, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (110671, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (445188, 'Blue and Gold Opportunity Plan', 'California residents', false, + 'Most California families earning up to $100,000 get UC tuition covered.', + 'No separate application. File the FAFSA or the California Dream Act Application by March 2.', + 'https://admission.universityofcalifornia.edu/tuition-financial-aid/types-of-aid/blue-and-gold-opportunity-plan.html'), + (228778, 'Texas Advance Commitment', 'Texas residents', false, + 'Full tuition for Texas residents with family income up to $100,000, and help with tuition up to $125,000.', + 'File the FAFSA or TASFA by UT’s priority deadline.', + 'https://admissions.utexas.edu/cost-aid/financial-aid/texas-advance-commitment/'), + (228723, 'Aggie Assurance', 'Texas residents', false, + 'From fall 2026, free tuition and fees for Texas residents with family income and assets under $100,000.', + 'File the FAFSA or TASFA by the state priority deadline.', + 'https://stories.tamu.edu/news/2026/02/20/texas-am-university-reinforces-commitment-to-affordable-education-with-expanded-aid/'), + (234076, 'AccessUVA', 'Virginia residents', true, + 'Grants cover at least tuition and fees for Virginia families earning $100,000 or less. At $50,000 or less, housing and dining are covered too.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://news.virginia.edu/content/uva-expands-financial-aid-program-virginia-families'), + (199120, 'Free tuition under $80K', 'North Carolina residents', true, + 'Tuition and mandatory fees are covered for in-state students from families earning less than $80,000.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://studentaid.unc.edu/tar-heel-guarantee/'), + (145637, 'Illinois Commitment', 'Illinois residents', false, + 'Free tuition and campus fees for Illinois residents with family income and assets of $75,000 or less each.', + 'File the FAFSA before March 15.', + 'https://www.osfa.illinois.edu/illinois-commitment/'), + (240444, 'Bucky’s Tuition Promise', 'Wisconsin residents', false, + 'Free tuition and fees for Wisconsin residents with a household income (AGI) of $65,000 or less. Assets are not counted.', + 'No separate application. File the FAFSA by the December 1 priority deadline.', + 'https://financialaid.wisc.edu/types-of-aid/tuition-promise/'), + (204680, 'Buckeye Opportunity Program', 'Ohio residents', false, + 'Tuition and mandatory fees are covered for Ohio residents who qualify for a Pell Grant.', + 'File the FAFSA by Ohio State’s Feb 1 priority date, every year.', + 'https://news.osu.edu/buckeye-opportunity-program-helps-keep-college-affordable-at-ohio-state/'), + (204796, 'Buckeye Opportunity Program', 'Ohio residents', false, + 'Tuition and mandatory fees are covered for Ohio residents who qualify for a Pell Grant.', + 'File the FAFSA by Ohio State’s Feb 1 priority date, every year.', + 'https://news.osu.edu/buckeye-opportunity-program-helps-keep-college-affordable-at-ohio-state/'), + (204662, 'Buckeye Opportunity Program', 'Ohio residents', false, + 'Tuition and mandatory fees are covered for Ohio residents who qualify for a Pell Grant.', + 'File the FAFSA by Ohio State’s Feb 1 priority date, every year.', + 'https://news.osu.edu/buckeye-opportunity-program-helps-keep-college-affordable-at-ohio-state/'), + (204671, 'Buckeye Opportunity Program', 'Ohio residents', false, + 'Tuition and mandatory fees are covered for Ohio residents who qualify for a Pell Grant.', + 'File the FAFSA by Ohio State’s Feb 1 priority date, every year.', + 'https://news.osu.edu/buckeye-opportunity-program-helps-keep-college-affordable-at-ohio-state/'), + (204699, 'Buckeye Opportunity Program', 'Ohio residents', false, + 'Tuition and mandatory fees are covered for Ohio residents who qualify for a Pell Grant.', + 'File the FAFSA by Ohio State’s Feb 1 priority date, every year.', + 'https://news.osu.edu/buckeye-opportunity-program-helps-keep-college-affordable-at-ohio-state/'), + (204705, 'Buckeye Opportunity Program', 'Ohio residents', false, + 'Tuition and mandatory fees are covered for Ohio residents who qualify for a Pell Grant.', + 'File the FAFSA by Ohio State’s Feb 1 priority date, every year.', + 'https://news.osu.edu/buckeye-opportunity-program-helps-keep-college-affordable-at-ohio-state/'), + (163286, 'Terrapin Commitment', 'Maryland residents', false, + 'Tuition and fees are covered for Maryland residents who are Pell-eligible or from families earning $75,000 or less.', + 'File the FAFSA by March 1, every year.', + 'https://financialaid.umd.edu/terrapin-commitment'), + (139755, 'Tech Promise', 'Georgia residents', true, + 'A debt-free degree for Georgia residents from families earning under $55,500.', + 'File the FAFSA and the CSS Profile by the school’s financial aid deadline.', + 'https://www.techpromise.em.gatech.edu/'), + (236948, 'Husky Promise', 'Washington residents', false, + 'Full tuition and standard fees for Washington residents who qualify for a Pell Grant.', + 'File the FAFSA or WASFA by UW’s priority date.', + 'https://www.washington.edu/huskypromise/'), + (134130, 'Machen Florida Opportunity Scholars', null, false, + 'Full need met with grants and scholarships for first-generation students with family income under $55,000 and assets under $35,000.', + 'File the FAFSA by UF’s priority deadline.', + 'https://www.sfa.ufl.edu/mfos') +) +update public.colleges c set + aid_guarantee = v.aid_guarantee, + aid_guarantee_residents = v.aid_guarantee_residents, + aid_guarantee_needs_css = v.aid_guarantee_needs_css, + aid_guarantee_detail = v.aid_guarantee_detail, + aid_guarantee_action = v.aid_guarantee_action, + aid_guarantee_url = v.aid_guarantee_url, + aid_guarantee_checked_on = date '2026-09-30' +from guarantees v +where c.scorecard_id = v.scorecard_id; + +-- A guarantee is the four text fields together or none of them. A partial row +-- would show a guarantee with no steps to get it, so it is refused at the +-- database rather than hidden in the app. Residents may be null on its own. +alter table public.colleges drop constraint if exists colleges_aid_guarantee_complete; +alter table public.colleges add constraint colleges_aid_guarantee_complete check ( + num_nulls(aid_guarantee, aid_guarantee_detail, aid_guarantee_action, aid_guarantee_url) in (0, 4) +); diff --git a/web/src/components/AidGuideSections.tsx b/web/src/components/AidGuideSections.tsx new file mode 100644 index 0000000..84bed4f --- /dev/null +++ b/web/src/components/AidGuideSections.tsx @@ -0,0 +1,268 @@ +import { useEffect, useState, type ReactNode } from 'react' +import { C, MODULE_COLORS } from '../lib/designTokens' +import { fetchAllGuarantees, type AidGuarantee, type GuaranteeList } from '../lib/aidColleges' +import { formatCollegeDate, parseIsoDay } from '../data/applicationDeadlines' +import { SecLabel } from './moduleUI' +import { + AID_FACTS_AS_OF, + guaranteeLabel, + MAJOR_PROGRAMS, + SCHOLARSHIP_CATEGORIES, + STATE_GRANTS, + type AidProgram, + type GrantState, +} from '../data/aidPrograms' + +const MC = MODULE_COLORS.financialAid + +/** + * One color per source of money, carried through a row's icon, edge, figures + * and links: federal and national programs blue, the school itself amber (the + * row not to skip), the state green, scholarships purple. + */ +// Line icons in the module's own stroke style, drawn in the row's color. +const svg = (children: ReactNode) => ( + +) +const ICONS = { + // Columned building: federal and national programs. + big: svg(<>), + // Mortarboard: the school's own aid. + uni: svg(<>), + // Map pin: the student's state. + state: svg(<>), + // Rosette: scholarships. + types: svg(<>), +} + +const ROWS = { + big: { color: '#1D7FC4', icon: ICONS.big }, + uni: { color: '#C47A12', icon: ICONS.uni }, + state: { color: MC, icon: ICONS.state }, + types: { color: '#7048C8', icon: ICONS.types }, +} as const + +/** Each kind of scholarship gets its own chip, so the five read apart at a glance. */ +const CATEGORY_COLOR: Record = { + merit: '#7048C8', + need: '#1D7FC4', + institutional: '#C47A12', + national: MC, + specialized: '#3F5BA9', +} + +const SANS = "'Outfit',sans-serif" + +export type AidGuideDestination = 'fafsa' | 'deadlines' | 'aid-compare' | 'scholarship-search' + +const Chevron = () => ( + +) + +const ExtLink = ({ href, children, color = MC }: { href: string; children: ReactNode; color?: string }) => ( + + {children} ↗ + +) + +/** One entry inside an open row: name and figure on top, the explanation under it. */ +const Item = ({ title, figure, children, links, color = MC, chip }: { + title: string + figure?: string + children: ReactNode + links?: ReactNode + color?: string + /** Render the title as a colored chip instead of bold text. */ + chip?: boolean +}) => ( +
+
+
+ {chip + ? {title} + : {title}} + {figure && · {figure}} +
+
{children}
+
+ {links &&
{links}
} +
+) + +const ProgramItem = ({ p, color }: { p: AidProgram; color: string }) => ( + {l.label}) : Site} + > + {p.summary}{p.note && <> {p.note}} + +) + +const GuaranteeItem = ({ g }: { g: AidGuarantee }) => ( + Aid page}> + {g.detail} To get it: {g.action} + +) + +/** "Edvifi can ___" — one line at the foot of a row, pointing at the tool that does it. */ +const EdvifiCan = ({ can, cta, onClick, color = MC }: { can: string; cta: string; onClick: () => void; color?: string }) => ( + // A quiet tinted strip rather than a banner: it should read as the next step, + // not as an ad, but still be the first thing the eye lands on at the bottom. +
+ + + Edvifi can {can} + + +
+) + +/** A collapsible row in the same shape as the checklist sections below it. */ +const Row = ({ kind, title, summary, tag, open, onToggle, children }: { + kind: keyof typeof ROWS + title: string + summary: string + tag?: string + open: boolean + onToggle: () => void + children: ReactNode +}) => { + const { color, icon } = ROWS[kind] + const [hover, setHover] = useState(false) + const edge = open || hover ? `${color}45` : C.border + return ( + // Longhands only. Mixing the `border` shorthand with `borderLeft` lets React + // re-apply the shorthand on toggle and wipe the colored edge. +
+ + {open &&
{children}
} +
+ ) +} + +const Intro = ({ children }: { children: ReactNode }) => ( +

{children}

+) + +export type GuideRowId = 'big' | 'uni' | 'state' | 'types' + +interface Props { + /** The student's state, when their ZIP tells us. Puts their grant first. */ + homeState: GrantState | null + /** Guarantees at schools the student has added, in their list order. */ + yourSchools: AidGuarantee[] + /** The list lookup failed, so "none on your list" would be a guess. */ + listFailed: boolean + /** Which row is open. Held by the caller so it survives opening an article and coming back. */ + open: GuideRowId | null + onOpenChange: (row: GuideRowId | null) => void + onGoTo: (dest: AidGuideDestination) => void +} + +export default function AidGuideSections({ homeState, yourSchools, listFailed, open, onOpenChange, onGoTo }: Props) { + // The full list is only needed once the row is opened. + const [all, setAll] = useState(null) + const toggle = (id: GuideRowId) => { + // Reopening after a failed load tries again. + if (id === 'uni' && open !== 'uni' && all === 'failed') setAll(null) + onOpenChange(open === id ? null : id) + } + useEffect(() => { + if (open !== 'uni' || all !== null) return + let cancelled = false + fetchAllGuarantees() + .then((list) => { if (!cancelled) setAll(list) }) + .catch(() => { if (!cancelled) setAll('failed') }) + return () => { cancelled = true } + }, [open, all]) + + const homeGrant = STATE_GRANTS.find((g) => g.state === homeState) + const stateGrants = homeGrant ? [homeGrant, ...STATE_GRANTS.filter((g) => g !== homeGrant)] : STATE_GRANTS + const n = yourSchools.length + const checked = all && all !== 'failed' && all.checkedOn ? parseIsoDay(all.checkedOn) : null + + return ( +
+ Know your aid + + toggle('big')}> + {MAJOR_PROGRAMS.map((p) => )} + onGoTo('fafsa')} /> + + + 0 + ? `${n} ${n === 1 ? 'school' : 'schools'} on your list ${n === 1 ? 'has an aid guarantee' : 'have aid guarantees'}. Check whether you qualify` + : 'Many schools guarantee free tuition below a family income, if you file their forms'} + tag="Don’t skip" + open={open === 'uni'} + onToggle={() => toggle('uni')} + > + + Guarantees only apply if you finish that school’s aid steps on time. That can mean the CSS Profile, the + school’s own form, or the FAFSA by an early date. Check the aid page of every school on your list. + + {yourSchools.map((g) => )} +
+ + {n > 0 ? 'All' : 'See all'} {all && all !== 'failed' ? `${all.guarantees.length} ` : ''}schools with a guarantee + + {all === null && Loading…} + {all === 'failed' && Couldn’t load the full list just now.} + {all && all !== 'failed' && ( + <> + {all.guarantees.map((g) => )} + {checked &&

Checked against each school’s site on {formatCollegeDate(checked)}.

} + + )} +
+ onGoTo('aid-compare')} /> + + + toggle('state')} + > + Most states have aid for residents who stay in state. If yours isn’t here, search “[your state] higher education grant”. + {stateGrants.map((g) => )} + onGoTo('deadlines')} /> + + + toggle('types')}> + {SCHOLARSHIP_CATEGORIES.map((c) => {c.description} {c.example}.)} + onGoTo('scholarship-search')} /> + + +

+ Amounts are for {AID_FACTS_AS_OF} and change every year. Confirm on the official site. +

+
+ ) +} diff --git a/web/src/components/CollegeDiscoverTab.test.tsx b/web/src/components/CollegeDiscoverTab.test.tsx index 04a8da9..74b3b38 100644 --- a/web/src/components/CollegeDiscoverTab.test.tsx +++ b/web/src/components/CollegeDiscoverTab.test.tsx @@ -23,6 +23,7 @@ const H = vi.hoisted(() => { legacy_slug: null, emoji: null, early_action: null, early_decision: null, regular_decision: null, fafsa_priority: null, css_profile: null, aid_notification: null, meets_full_need: null, no_loan_policy: null, curated_at: null, + aid_guarantee: null, aid_guarantee_detail: null, aid_guarantee_needs_css: null, aid_guarantee_residents: null, aid_guarantee_action: null, aid_guarantee_url: null, aid_guarantee_checked_on: null, ...over, }) const SAMPLE: College[] = [ diff --git a/web/src/components/Dashboard.tsx b/web/src/components/Dashboard.tsx index 3dfc9a6..ee2baed 100644 --- a/web/src/components/Dashboard.tsx +++ b/web/src/components/Dashboard.tsx @@ -17,6 +17,7 @@ import { reportError } from '../lib/errorTracking' import { resolveDeadlinePreferences } from '../lib/preferences' import WeekOverview from './WeekOverview' import DeadlinePanel from './DeadlinePanel' +import OverviewRail, { RailToggle } from './OverviewRail' import { nextDueForModule, type DeadlineEvent, @@ -240,6 +241,14 @@ export default function Dashboard({ startIdx, answers, firstName, onSignOut }: P onOpenDay={(day) => { setOpenModule(null); setCalendarDay(day); setPage('calendar') }} /> ) + + // The same rail inside each module's Overview, sharing this page's open state. + const moduleRail = ( + setSidebarOpen((o) => !o)}> + {deadlineRail} + + ) + const nextDueByModule = useMemo(() => { // A module card's "next due": not something already ticked off, and not a // date the student put on one of its tasks (those are steps toward a @@ -532,19 +541,11 @@ export default function Dashboard({ startIdx, answers, firstName, onSignOut }: P {/* Sidebar toggle — fixed on the border */} - + /> {/* Right sidebar — collapsible */}