diff --git a/web/src/components/AidGuideSections.tsx b/web/src/components/AidGuideSections.tsx index cd779bd..49a0b4a 100644 --- a/web/src/components/AidGuideSections.tsx +++ b/web/src/components/AidGuideSections.tsx @@ -54,7 +54,7 @@ const CATEGORY_COLOR: Record = { const SANS = "'Outfit',sans-serif" -export type AidGuideDestination = 'fafsa' | 'deadlines' | 'scholarship-search' +export type AidGuideDestination = 'fafsa' | 'scholarships' | 'scholarship-search' const Chevron = () => ( @@ -270,7 +270,7 @@ export default function AidGuideSections({ homeState, yourSchools, listFailed, o {otherGrants.map(grantItem)} ) : otherGrants.map(grantItem)} - onGoTo('deadlines')} /> + onGoTo('scholarships')} /> toggle('types')}> diff --git a/web/src/components/ChecklistContentView.tsx b/web/src/components/ChecklistContentView.tsx index fb0479f..7b7c560 100644 --- a/web/src/components/ChecklistContentView.tsx +++ b/web/src/components/ChecklistContentView.tsx @@ -19,6 +19,8 @@ interface Props { contentMap: Record allIds: string[] accentColor: string + /** Where Back goes, as its label says it. */ + backLabel?: string onBack: () => void onMarkComplete: (itemId: string) => void onNavigate: (itemId: string) => void @@ -36,6 +38,7 @@ export default function ChecklistContentView({ contentMap, allIds, accentColor, + backLabel = 'Back to Overview', onBack, onMarkComplete, onNavigate, @@ -51,7 +54,7 @@ export default function ChecklistContentView({ return (

Content not found for this item.

@@ -64,7 +67,7 @@ export default function ChecklistContentView({ return (
diff --git a/web/src/components/FafsaModuleTour.tsx b/web/src/components/FafsaModuleTour.tsx index be7740b..34f366f 100644 --- a/web/src/components/FafsaModuleTour.tsx +++ b/web/src/components/FafsaModuleTour.tsx @@ -12,9 +12,9 @@ import { MODULE_COLORS } from '../lib/designTokens' export type TourTabId = | 'overview' + | 'scholarships-101' | 'scholarships' | 'scholarship-search' - | 'deadlines' interface Props { onDismiss: () => void @@ -56,10 +56,19 @@ const STEPS: TourStep[] = [ keepClear: ['content'], }, + { + selector: '[data-tour="tab-scholarships-101"]', + pad: 6, + title: 'Scholarships 101', + desc: 'How scholarships work, where to find ones you qualify for, and how to apply, in six short steps.', + switchTab: 'scholarships-101', + keepClear: ['sidebar', 'content'], + }, + { selector: '[data-tour="tab-scholarship-search"]', pad: 6, - title: 'Aid Engine', + title: 'Scholarship Engine', // Points at the tab, not into it: on a first visit the tab is the // preferences form, so its filters aren't there to point at yet. desc: 'Answer a few questions and we score every scholarship for how well it fits you, with a few picked to start on. Track the ones worth applying to.', @@ -70,29 +79,12 @@ const STEPS: TourStep[] = [ { selector: '[data-tour="tab-scholarships"]', pad: 6, - title: 'My Scholarships', - desc: 'Every scholarship you track, with its deadline, its status and a checklist of what to send. Things like your transcript count once for all of them.', + title: 'Aid Tracker', + desc: 'When the FAFSA and CSS Profile are due at each of your schools, then every scholarship you track, with its deadline, its status and a checklist of what to send.', switchTab: 'scholarships', keepClear: ['sidebar', 'content'], }, - { - selector: '[data-tour="tab-deadlines"]', - pad: 6, - title: 'Deadlines', - desc: 'Track financial aid deadlines for your college list. Missing a priority deadline can cost thousands.', - switchTab: 'deadlines', - keepClear: ['sidebar', 'content'], - }, - { - selector: '[data-tour="deadlines-search"]', - pad: 8, - title: 'Add Colleges', - desc: 'Search and add colleges to see their FAFSA, CSS Profile, and aid letter deadlines with urgency indicators.', - switchTab: 'deadlines', - keepClear: ['content'], - }, - { selector: '[data-tour="breadcrumb"]', pad: 6, diff --git a/web/src/components/FinancialAidModule.test.tsx b/web/src/components/FinancialAidModule.test.tsx new file mode 100644 index 0000000..142483d --- /dev/null +++ b/web/src/components/FinancialAidModule.test.tsx @@ -0,0 +1,91 @@ +import { describe, it, expect, vi } from 'vitest' +import { render, screen } from '@testing-library/react' +import userEvent from '@testing-library/user-event' +import { AidForms, Scholarships101Tab } from './FinancialAidModule' +import { ContentBlockRenderer } from './contentBlocks' +import type { AidCollege } from '../lib/aidColleges' + +vi.mock('../lib/supabase', () => ({ supabase: {} })) + +const school = (name: string, over: Partial = {}): AidCollege => ({ + id: name, canonicalId: name, name, emoji: '🎓', domain: null, type: '4-year', control: 'Private', isPublic: false, + city: null, state: null, npcUrl: null, costOfAttendance: null, costOutOfState: null, + applicationDeadlines: { earlyAction: null, earlyDecision: null, regularDecision: null }, + financialAidDeadlines: { fafsaPriority: null, cssProfile: null, aidNotification: null }, + meetsFullNeed: false, noLoanPolicy: false, curated: false, guarantee: null, + ...over, +}) +const state = (colleges: AidCollege[]) => ({ colleges, loading: false, failed: false, unresolved: [] }) + +describe('AidForms', () => { + const list = state([ + school('Duke', { curated: true, financialAidDeadlines: { fafsaPriority: 'Feb 1, 2027', cssProfile: 'Nov 1, 2026', aidNotification: null } }), + school('UNC', { isPublic: true, control: 'Public', financialAidDeadlines: { fafsaPriority: 'Jan 15, 2027', cssProfile: null, aidNotification: null } }), + school('Elon'), + ]) + + it('sums up the list and opens onto each school', async () => { + render() + expect(screen.getByText(/^Your earliest school date: Jan 15, \d{4} \(UNC\)$/)).toBeInTheDocument() + expect(screen.getByText('Needed by 1 of your 3 schools; 1 more may need it')).toBeInTheDocument() + + const css = screen.getByRole('button', { name: /CSS Profile/ }) + expect(css).toHaveAttribute('aria-expanded', 'false') + await userEvent.click(css) + expect(css).toHaveAttribute('aria-expanded', 'true') + expect(screen.getByText(/^Nov 1, \d{4}$/)).toBeInTheDocument() + expect(screen.getByText('Check its aid page')).toBeInTheDocument() + expect(screen.getByText('Not usually')).toBeInTheDocument() + }) + + it('goes to Aid Tracker instead of opening on Overview', async () => { + const onSeeSchools = vi.fn() + render() + const fafsa = screen.getByRole('button', { name: /FAFSA/ }) + expect(fafsa).not.toHaveAttribute('aria-expanded') + await userEvent.click(fafsa) + expect(onSeeSchools).toHaveBeenCalledOnce() + expect(screen.queryByText('No date on file')).not.toBeInTheDocument() + }) + + it('points an empty list at Application Tracking', async () => { + render() + expect(screen.getAllByText('Add schools in Application Tracking to see what each one asks for')).toHaveLength(2) + await userEvent.click(screen.getByRole('button', { name: /FAFSA/ })) + expect(screen.getByRole('link', { name: 'Application Tracking' })).toHaveAttribute('href', '#/dashboard/application-tracking/discover') + }) +}) + +describe('Scholarships 101', () => { + it('lists the six steps in order and opens each one', async () => { + const onToggle = vi.fn() + render() + expect(screen.getByText('1/6 completed')).toBeInTheDocument() + await userEvent.click(screen.getByText('Understanding scholarships: types, eligibility, and how they work')) + expect(onToggle).toHaveBeenCalledWith('sr-5') + expect(screen.getByText('1 of 6')).toBeInTheDocument() + expect(screen.getByRole('heading', { name: 'What Is a Scholarship?' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: /Back to Scholarships 101/ })).toBeInTheDocument() + // Last step's article is there too, and the "next" button stops at it. + await userEvent.click(screen.getByRole('button', { name: /Back to Scholarships 101/ })) + await userEvent.click(screen.getByText('Identify 10 scholarships to apply to senior year')) + expect(screen.getByText('6 of 6')).toBeInTheDocument() + expect(screen.queryByText('Content not found for this item.')).not.toBeInTheDocument() + }) +}) + +describe('content blocks', () => { + it('renders bold, italic, numbered lists and tables', () => { + const { container } = render(<> + + + + ) + expect(container.querySelector('strong')?.textContent).toBe('how often') + expect(container.querySelector('em')?.textContent).toBe('can') + expect(screen.getByText(/, 3 \* 2$/)).toBeInTheDocument() + expect(container.querySelector('ol')?.textContent).toBe('1.First2.Second') + expect(screen.getByRole('columnheader', { name: 'Factor' })).toBeInTheDocument() + expect(container.querySelectorAll('td')[1].innerHTML).toBe('Do I qualify?') + }) +}) diff --git a/web/src/components/FinancialAidModule.tsx b/web/src/components/FinancialAidModule.tsx index e2fb561..e8b6903 100644 --- a/web/src/components/FinancialAidModule.tsx +++ b/web/src/components/FinancialAidModule.tsx @@ -1,5 +1,5 @@ import { useState, useEffect, useMemo, useRef, useCallback, type ReactNode } from 'react' -import { formatCollegeDate, parseIsoDay, scholarshipDeadlineState, seniorFallYear, daysLabel, fafsaOpening, inStudentCycle, deriveScholarshipEvents, urgencyColor, roughDuration, resolveAppDeadline, type DeadlineEvent } from '../data/applicationDeadlines' +import { formatCollegeDate, parseCollegeDate, parseIsoDay, scholarshipDeadlineState, seniorFallYear, daysLabel, fafsaOpening, fafsaFederalDeadline, cssProfileOpening, inStudentCycle, deriveScholarshipEvents, urgencyColor, roughDuration, type DeadlineEvent } from '../data/applicationDeadlines' import { useModuleData, useModuleValue } from '../lib/useModuleState' import { AnimatePresence, motion } from 'framer-motion' import { useAuth } from '../contexts/AuthContext' @@ -11,7 +11,7 @@ import Celebration from './Celebration' import { AddDateCue, DateBlock, DoneBlock } from './ApplicationStatusTab' import { TaskDueInput } from './SchoolApplicationPage' import { TASK_PHASES } from '../data/applicationTasks' -import type { AppDeadlineType, AppTask } from '../data/applicationsChecklist' +import type { AppTask } from '../data/applicationsChecklist' import { scholarshipTasks, ownTasks, isSharedScholarshipTask, isOpenStatus, sharedScholarshipSummary, needsEssay, needsWorkSample } from '../data/scholarshipTasks' import { DEFAULT_AID_PREFS, INTEREST_OPTIONS, fitsAidPrefs, interestTags, type AidPrefs } from '../lib/aidPrefs' import IngestionHealthPanel from './IngestionHealthPanel' @@ -40,7 +40,6 @@ import { parseIncomeToRange, parseGpa, getCollegeList, - setCollegeList as saveCollegeList, type Scholarship, type TrackerItem as DBTrackerItem, type TrackerStatus as DBTrackerStatus, @@ -54,20 +53,20 @@ import { parseTrackerAmount, inferScholarshipType, } from '../lib/fafsaData' -import { ListFailed, ListLoading, UnresolvedNotice } from './AidCompare' +import { UnresolvedNotice } from './AidCompare' import { supabase } from '../lib/supabase' import type { Demographics } from '../types/user' import { CHECKLIST_CONTENT_MAP } from '../data/checklistContent' -import { searchAidColleges, type AidCollege } from '../lib/aidColleges' +import type { AidCollege } from '../lib/aidColleges' import { useAidColleges, type AidCollegesState } from '../lib/useAidColleges' import { C, MODULE_COLORS, EASE_OUT, CARET_SELECT } from '../lib/designTokens' import { useIsNarrow } from '../lib/useMediaQuery' import ChecklistContentView from './ChecklistContentView' import AidGuideSections, { type AidGuideDestination, type GuideRowId } from './AidGuideSections' -import { stateFromZip, guaranteeLabel } from '../data/aidPrograms' +import { stateFromZip } from '../data/aidPrograms' import { Bar, CollegeLogo, SecLabel, Tag } from './moduleUI' import { logoUrlForDomain } from '../lib/collegeLogo' -import { routedTab, useRoutedTab } from '../lib/hashRoute' +import { formatRoute, routedTab, useRoutedTab } from '../lib/hashRoute' import { MODULE_ICONS } from './moduleIcons' import ModuleTabNav from './ModuleTabNav' import { ModuleHeaderEnd, TEXT_FIELD } from './ModuleShell' @@ -110,15 +109,6 @@ const CHECKLIST_SECTIONS: ChecklistSection[] = [ { id: 'fp-5', label: 'CSS Profile: who needs it and how it differs', type: 'article' }, ], }, - { - title: 'Scholarship Research', - items: [ - { id: 'sr-1', label: 'How to find scholarships you actually qualify for', type: 'article' }, - { id: 'sr-2', label: 'Build your scholarship tracker', type: 'assignment' }, - { id: 'sr-3', label: 'Local vs. national scholarships: where to start', type: 'article' }, - { id: 'sr-4', label: 'Identify 10 scholarships to apply to senior year', type: 'task' }, - ], - }, { title: 'Net Price Calculators', items: [ @@ -129,8 +119,22 @@ const CHECKLIST_SECTIONS: ChecklistSection[] = [ }, ] -const CHECKLIST_TOTAL_ITEMS = CHECKLIST_SECTIONS.reduce((a, s) => a + s.items.length, 0) -const CHECKLIST_ALL_IDS = CHECKLIST_SECTIONS.flatMap((s) => s.items.map((i) => i.id)) +/** Scholarships 101's tab, in the content team's reading order. Its items + * were Overview's "Scholarship Research" section, so they keep those ids + * and whatever progress a student already has on them. */ +const SCHOLARSHIPS_101: ChecklistItem[] = [ + { id: 'sr-5', label: 'Understanding scholarships: types, eligibility, and how they work', type: 'article' }, + { id: 'sr-1', label: 'How to find scholarships you actually qualify for', type: 'article' }, + { id: 'sr-3', label: 'Local vs. national scholarships: where to start', type: 'article' }, + { id: 'sr-2', label: 'Build your scholarship tracker', type: 'assignment' }, + { id: 'sr-6', label: 'How to apply for scholarships and improve your chances', type: 'article' }, + { id: 'sr-4', label: 'Identify 10 scholarships to apply to senior year', type: 'task' }, +] + +const OVERVIEW_IDS = CHECKLIST_SECTIONS.flatMap((s) => s.items.map((i) => i.id)) +const SCHOLARSHIPS_101_IDS = SCHOLARSHIPS_101.map((i) => i.id) +/** Every item in the module, for the sidebar's progress. */ +const CHECKLIST_TOTAL_ITEMS = OVERVIEW_IDS.length + SCHOLARSHIPS_101_IDS.length function nextChecklistStatus(current: ChecklistItemStatus): ChecklistItemStatus { if (current === 'available') return 'in-progress' @@ -150,24 +154,8 @@ const STATUS_META: Record { - const a = college.applicationDeadlines - return round ? [resolveAppDeadline(a, round)] : [a.earlyAction, a.earlyDecision, a.regularDecision] -} - -function computeUrgency(college: AidCollege, round: AppDeadlineType | undefined): 'high' | 'medium' | 'low' | 'none' { - const allDates = [ - ...appDates(college, round), - college.financialAidDeadlines.fafsaPriority, - college.financialAidDeadlines.cssProfile, - ].filter(Boolean) as string[] - - let minDays = Infinity - for (const ds of allDates) { - const d = daysUntil(ds) - if (d !== null && d >= 0 && d < minDays) minDays = d - } - - // Most schools have no checked dates; "On Track" there would be reassurance - // with nothing behind it. - if (minDays === Infinity) return 'none' - if (minDays <= 30) return 'high' - if (minDays <= 90) return 'medium' - return 'low' -} - -function computeDaysNote(college: AidCollege, round: AppDeadlineType | undefined): string { - if (college.meetsFullNeed && college.noLoanPolicy) return 'Meets 100% need, no-loan policy' - if (college.meetsFullNeed) return 'Meets 100% of demonstrated need' - const rd = round ? resolveAppDeadline(college.applicationDeadlines, round) : college.applicationDeadlines.regularDecision - if (rd === null) return '' - const d = daysUntil(rd) - if (d !== null && d >= 0) return `~${d} days until app deadline` - if (rd === 'Rolling') return 'Rolling admissions' - return '' -} +type CssNeed = 'required' | 'check' | 'no' +/** Whether the school wants the CSS Profile, by its task list's rule + * (cssProfileNeed): a date on file or a guarantee that takes it, and "check" + * for a private four-year school nobody has verified. */ +const cssNeed = (c: AidCollege): CssNeed => + c.financialAidDeadlines.cssProfile || c.guarantee?.needsCss ? 'required' + : c.curated || c.isPublic || c.type !== '4-year' ? 'no' : 'check' function formatScholarshipAmount(s: Scholarship): string { if (s.award_amount_cents && s.award_amount_cents > 0) { @@ -251,14 +206,14 @@ function deadlineBadge( return null } -/** Scholarships the student marked "Not interested", hidden from the Aid Engine. */ +/** Scholarships the student marked "Not interested", hidden from the Scholarship Engine. */ interface Dismissals { ids: Set dismiss: (s: Scholarship) => void restore: (id: string) => void } -// Sized like the Aid Engine's match chips it sits beside. +// Sized like the Scholarship Engine's match chips it sits beside. const chipStyle = (on: boolean) => ({ padding: '6px 12px', borderRadius: 99, border: `1px solid ${on ? MC + '50' : C.border}`, background: on ? `${MC}12` : C.white, color: on ? MC : C.text, @@ -313,17 +268,95 @@ const Callout = ({ icon, title, body, color = MC, bg }: { icon: ReactNode; title /* ═══════════════════════════════════════════════════════════════ MODULE TAB NAV ═══════════════════════════════════════════════════════════════ */ -// Aid Compare moved to Application Tracking, where it compares that list. -type TabId = 'overview' | 'scholarships' | 'scholarship-search' | 'deadlines' +// Aid Compare moved to Application Tracking, where it compares that list, and +// Deadlines' FAFSA and CSS Profile dates to the top of Aid Tracker. +type TabId = 'overview' | 'scholarships-101' | 'scholarships' | 'scholarship-search' const FA_TABS: Array<{ id: TabId; label: string; icon: ReactNode }> = [ { id: 'overview', label: 'Overview', icon: I.overview }, - { id: 'scholarship-search', label: 'Aid Engine', icon: I.sparkle }, - { id: 'scholarships', label: 'My Scholarships', icon: I.star }, - { id: 'deadlines', label: 'Deadlines', icon: I.cal }, + { id: 'scholarships-101', label: 'Scholarships 101', icon: I.article }, + { id: 'scholarship-search', label: 'Scholarship Engine', icon: I.sparkle }, + { id: 'scholarships', label: 'Aid Tracker', icon: I.star }, ] const FA_TAB_IDS = FA_TABS.map((t) => t.id) +/* ═══════════════════════════════════════════════════════════════ + CHECKLIST ITEMS — shared by Overview and Scholarships 101 + ═══════════════════════════════════════════════════════════════ */ +/** The item open for reading, and the status moves that come with it: + * opening one starts it, and its button walks it to complete and back. */ +function useChecklistReader(progress: ChecklistProgressMap, onToggle: (itemId: string) => void) { + const [activeId, setActiveId] = useState(null) + const statusOf = (id: string): ChecklistItemStatus => progress[id] ?? 'available' + const open = (itemId: string) => { + if (statusOf(itemId) === 'available') onToggle(itemId) + setActiveId(itemId) + } + const markComplete = (itemId: string) => { + onToggle(itemId) + // From not started, the second step takes it from in progress to complete. + if (statusOf(itemId) === 'available') setTimeout(() => onToggle(itemId), 50) + } + return { activeId, setActiveId, statusOf, open, markComplete } +} + +const ChecklistRow = ({ item, status, first, inset, onOpen }: { item: ChecklistItem; status: ChecklistItemStatus; first: boolean; inset: boolean; onOpen: () => void }) => ( +
((e.currentTarget as HTMLDivElement).style.background = C.surfaceHover)} + onMouseLeave={(e) => ((e.currentTarget as HTMLDivElement).style.background = 'transparent')} + > + + {itemIcon(item.type)} + {item.label} + {I.chevron} + {item.type} +
+) + +const ChecklistProgress = ({ done, total, tour }: { done: number; total: number; tour?: string }) => ( +
+
+ {done}/{total} completed +
+) + +/* ═══════════════════════════════════════════════════════════════ + TAB: SCHOLARSHIPS 101 + ═══════════════════════════════════════════════════════════════ */ +export const Scholarships101Tab = ({ progress, onToggle }: { progress: ChecklistProgressMap; onToggle: (itemId: string) => void }) => { + const reader = useChecklistReader(progress, onToggle) + if (reader.activeId) { + return ( + reader.setActiveId(null)} + onMarkComplete={reader.markComplete} + onNavigate={reader.open} + /> + ) + } + const done = SCHOLARSHIPS_101_IDS.filter((id) => reader.statusOf(id) === 'completed').length + return ( +
+

Scholarships 101

+

+ How scholarships work, where to find ones you qualify for, and how to apply. Work through them in order. +

+ +
+ {SCHOLARSHIPS_101.map((item, i) => reader.open(item.id)} />)} +
+
+ ) +} + /* ═══════════════════════════════════════════════════════════════ TAB: OVERVIEW ═══════════════════════════════════════════════════════════════ */ @@ -341,53 +374,13 @@ interface OverviewTabProps { gradeStartIdx: number | null | undefined } -/** The student's own FAFSA date, the one Deadlines and the calendar show. It - * was written in as "Oct 1", which stayed up after the form had opened. */ -function fafsaStat(gradeStartIdx: number | null | undefined) { - const now = new Date() - const { date } = fafsaOpening(seniorFallYear(gradeStartIdx, now)) - const opened = date <= now - const day = date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }) - return { - label: opened ? 'FAFSA Opened' : 'FAFSA Opens', - value: date.getFullYear() === now.getFullYear() ? day : `${day}, ${date.getFullYear()}`, - sub: opened ? 'Open now: file early' : 'Senior year', - color: '#2D9E72', - } -} - const OverviewTab = ({ progress, onToggle, aside, homeState, aid, onGoToTab, year, gradeStartIdx }: OverviewTabProps) => { - const [activeContentId, setActiveContentId] = useState(null) + const { activeId: activeContentId, setActiveId: setActiveContentId, statusOf, open: openContent, markComplete: handleMarkComplete } = useChecklistReader(progress, onToggle) // Lives here, not in the guide, so it survives opening an article and coming back. const [guideRow, setGuideRow] = useState(null) - const [expanded, setExpanded] = useState>({ 0: true, 1: true, 2: true, 3: true }) + const [expanded, setExpanded] = useState>({ 0: true, 1: true, 2: true }) const toggle = (i: number) => setExpanded((p) => ({ ...p, [i]: !p[i] })) - const statusOf = (id: string): ChecklistItemStatus => progress[id] ?? 'available' - const done = CHECKLIST_SECTIONS.reduce( - (a, s) => a + s.items.filter((x) => statusOf(x.id) === 'completed').length, - 0, - ) - const total = CHECKLIST_TOTAL_ITEMS - - const handleMarkComplete = (itemId: string) => { - const current = progress[itemId] ?? 'available' - if (current === 'completed') { - onToggle(itemId) - } else if (current === 'in-progress') { - onToggle(itemId) - } else { - onToggle(itemId) - setTimeout(() => onToggle(itemId), 50) - } - } - - const openContent = (itemId: string) => { - const current = progress[itemId] ?? 'available' - if (current === 'available') { - onToggle(itemId) - } - setActiveContentId(itemId) - } + const done = OVERVIEW_IDS.filter((id) => statusOf(id) === 'completed').length const handleGuideGoTo = (dest: AidGuideDestination) => { // Opened to read, not started: going through openContent would mark the @@ -402,7 +395,7 @@ const OverviewTab = ({ progress, onToggle, aside, homeState, aid, onGoToTab, yea itemId={activeContentId} status={statusOf(activeContentId)} contentMap={CHECKLIST_CONTENT_MAP} - allIds={CHECKLIST_ALL_IDS} + allIds={OVERVIEW_IDS} accentColor={MC} onBack={() => setActiveContentId(null)} onMarkComplete={handleMarkComplete} @@ -416,10 +409,7 @@ const OverviewTab = ({ progress, onToggle, aside, homeState, aid, onGoToTab, yea const checklist = (
-
-
- {done}/{total} completed -
+ Your Checklist @@ -433,24 +423,9 @@ const OverviewTab = ({ progress, onToggle, aside, homeState, aid, onGoToTab, yea {section.title} {sdone}/{section.items.length} - {isOpen && section.items.map((item, i) => { - const itemStatus = statusOf(item.id) - return ( -
openContent(item.id)} - style={{ display: 'flex', alignItems: 'center', gap: 11, padding: '10px 16px 10px 42px', borderTop: i > 0 ? `1px solid ${C.border}` : 'none', cursor: 'pointer' }} - onMouseEnter={(e) => ((e.currentTarget as HTMLDivElement).style.background = C.surfaceHover)} - onMouseLeave={(e) => ((e.currentTarget as HTMLDivElement).style.background = 'transparent')} - > - - {itemIcon(item.type)} - {item.label} - {I.chevron} - {item.type} -
- ) - })} + {isOpen && section.items.map((item, i) => ( + openContent(item.id)} /> + ))}
) })} @@ -475,9 +450,10 @@ const OverviewTab = ({ progress, onToggle, aside, homeState, aid, onGoToTab, yea : "You're early, and that's an advantage. The FAFSA opens in the fall of senior year; until then, building your scholarship list and running net price calculators puts you miles ahead."}

-
+
onGoToTab('scholarships')} />
+ +
{[ - fafsaStat(gradeStartIdx), { label: 'Avg. Aid Award', value: '$13,200', sub: 'Per year nationally', color: '#7048C8' }, { label: 'Scholarships', value: '1.7M+', sub: 'Available to students', color: '#C47A12' }, ].map((s, i) => ( @@ -491,7 +467,7 @@ const OverviewTab = ({ progress, onToggle, aside, homeState, aid, onGoToTab, yea {year >= 12 ? (
- +
) : year === 11 && (
@@ -511,7 +487,7 @@ const OverviewTab = ({ progress, onToggle, aside, homeState, aid, onGoToTab, yea } /* ═══════════════════════════════════════════════════════════════ - SCHOLARSHIPS — shared by My Scholarships and the Aid Engine + SCHOLARSHIPS — shared by Aid Tracker and the Scholarship Engine ═══════════════════════════════════════════════════════════════ */ const font = "'Outfit',sans-serif" @@ -536,7 +512,7 @@ const AmountText = ({ text, size }: { text: string; size: number }) => ) /** The student's tracked scholarships and every way to change them. Owned by - * the module so My Scholarships and the Aid Engine show the same list. */ + * the module so Aid Tracker and the Scholarship Engine show the same list. */ interface TrackerApi { items: DBTrackerItem[] loaded: boolean @@ -638,7 +614,7 @@ function CustomScholarshipForm({ initial, onSubmit, onCancel }: { disabled={!ready} style={{ padding: '7px 18px', borderRadius: 8, border: 'none', background: ready ? MC : C.border, color: ready ? '#fff' : C.textFaint, fontFamily: font, fontSize: 12, fontWeight: 600, cursor: ready ? 'pointer' : 'default' }} > - {initial ? (submitting ? 'Saving…' : 'Save changes') : (submitting ? 'Adding…' : 'Add to My Scholarships')} + {initial ? (submitting ? 'Saving…' : 'Save changes') : (submitting ? 'Adding…' : 'Add to Aid Tracker')}
@@ -827,12 +803,14 @@ const TaskBox = ({ done }: { done: boolean }) => ( ) -const ScholarshipsTab = ({ api, gradeStartIdx, initialOpenId, onFindScholarships }: { +const ScholarshipsTab = ({ api, aid, gradeStartIdx, initialOpenId, onFindScholarships }: { api: TrackerApi + /** The student's schools, for the FAFSA and CSS Profile boxes on top. */ + aid: AidCollegesState gradeStartIdx: number | null | undefined - /** Open straight onto this scholarship's page (from the Aid Engine's strip). */ + /** Open straight onto this scholarship's page (from the Scholarship Engine's strip). */ initialOpenId: string | null - /** Go to the Aid Engine, where scholarships are found. */ + /** Go to the Scholarship Engine, where scholarships are found. */ onFindScholarships: () => void }) => { const [openId, setOpenId] = useState(initialOpenId) @@ -866,17 +844,24 @@ const ScholarshipsTab = ({ api, gradeStartIdx, initialOpenId, onFindScholarships return ok } const addForm = setAdding(false)} /> + const yourAid = ( +
+

Your financial aid

+ +
+ ) if (items.length === 0) { return (
+ {yourAid}

Your scholarships

{adding ?
{addForm}
: (
Add scholarships to work on. Each gets its own checklist here.
)}
@@ -1621,7 +1607,7 @@ const PrefSection = ({ title, hint, children }: { title: string; hint?: string; const toggleIn = (list: T[], v: T): T[] => (list.includes(v) ? list.filter((x) => x !== v) : [...list, v]) -/** The Aid Engine's first-run questions, like Discover's CollegePrefsForm. */ +/** The Scholarship Engine's first-run questions, like Discover's CollegePrefsForm. */ function AidPrefsForm({ value, onSave, submitLabel, onCancel }: { value: AidPrefs; onSave: (next: AidPrefs) => void; submitLabel: string; onCancel?: () => void }) { const [d, setD] = useState(value) const types: Array<{ key: ScholarshipType; label: string }> = [ @@ -1678,7 +1664,7 @@ function AidPrefsForm({ value, onSave, submitLabel, onCancel }: { value: AidPref ) } -/** The student's tracked scholarships at the top of the Aid Engine, like +/** The student's tracked scholarships at the top of the Scholarship Engine, like * Discover's list strip: what's tracked and what's due next, one click away. */ function TrackedStrip({ api, onOpen }: { api: TrackerApi; onOpen: (id: string | null) => void }) { // On a phone the chips wrapped onto a row of their own the moment the first @@ -1688,7 +1674,7 @@ function TrackedStrip({ api, onOpen }: { api: TrackerApi; onOpen: (id: string | return (
- My Scholarships + Your scholarships
{api.items.length === 0 ? narrow ? 'Nothing tracked yet.' : 'Nothing tracked yet. Tap + Track on any match to start its checklist.' @@ -1720,7 +1706,7 @@ interface AidEngineTabProps { prefsLoaded: boolean onSavePrefs: (p: AidPrefs) => void dismissals: Dismissals - /** Show one tracked scholarship (or the list, for null) in My Scholarships. */ + /** Show one tracked scholarship (or the list, for null) in Aid Tracker. */ onOpenTracked: (id: string | null) => void /** The student's grade, 9–12, for awards open to only some of them. */ year: number @@ -1846,9 +1832,9 @@ const AidEngineTab = ({ api, userDemoTags, userDemographics, prefs, prefsLoaded, return (
-

Aid Engine

+

Scholarship Engine

- Scholarships scored for how well they fit you. Track any to work on it in My Scholarships. + Scholarships scored for how well they fit you. Track any to work on it in Aid Tracker.

{/* This catalogue is hand-curated and does not refresh itself, so dates and amounts drift between cycles. Saying so is the honest @@ -1971,298 +1957,119 @@ const AidEngineTab = ({ api, userDemoTags, userDemographics, prefs, prefsLoaded, } /* ═══════════════════════════════════════════════════════════════ - COLLEGE SEARCH (Deadlines) + AID FORMS — when the FAFSA and CSS Profile open and close, and + what each school on the list asks for. Took over from Deadlines. ═══════════════════════════════════════════════════════════════ */ -const CollegeSearch = ({ - collegeIds, - onAdd, - placeholder = 'Search colleges to add...', -}: { - /** - * Ids already on the list, in both shapes: the raw saved strings and the - * canonical `sc-` ids they resolve to. Comparing only the raw strings would - * offer "+ Add" for a school the student already has saved under a legacy - * slug, and adding it would put the same school on the list twice. - */ - collegeIds: string[] - onAdd: (id: string) => void - placeholder?: string -}) => { - const [query, setQuery] = useState('') - const [focused, setFocused] = useState(false) - const [results, setResults] = useState([]) - const [searching, setSearching] = useState(false) - const [searchFailed, setSearchFailed] = useState(false) - const wrapRef = useRef(null) - - // Debounced, because this now hits the ~6,300-row table rather than filtering - // a 46-element array in memory. Same debounce as Discover's name search. - useEffect(() => { - const q = query.trim() - let cancelled = false - const timer = setTimeout(async () => { - if (q.length < 2) { if (!cancelled) { setResults([]); setSearching(false) }; return } - if (!cancelled) { setSearching(true); setSearchFailed(false) } - try { - const r = await searchAidColleges(q, 8) - if (!cancelled) { setResults(r); setSearching(false) } - } catch { - // An empty dropdown would read as "no such school", which is the exact - // wrong message when the lookup is what failed. - if (!cancelled) { setResults([]); setSearchFailed(true); setSearching(false) } - } - }, q.length < 2 ? 0 : 220) - return () => { cancelled = true; clearTimeout(timer) } - }, [query]) - - const visible = results.filter((c) => !collegeIds.includes(c.canonicalId)).slice(0, 8) - - useEffect(() => { - const handler = (e: MouseEvent) => { - if (wrapRef.current && !wrapRef.current.contains(e.target as Node)) setFocused(false) - } - document.addEventListener('mousedown', handler) - return () => document.removeEventListener('mousedown', handler) - }, []) - - const showDropdown = focused && query.length >= 1 - - return ( -
-
-
- setQuery(e.target.value)} - onFocus={() => setFocused(true)} - placeholder={placeholder} - style={{ width: '100%', padding: '8px 12px', borderRadius: 8, border: `1px solid ${C.border}`, background: C.surface, fontFamily: "'Outfit',sans-serif", fontSize: 13, color: C.text, outline: 'none', boxSizing: 'border-box' }} - /> -
-
- - {showDropdown && ( -
- {visible.length === 0 ? ( -
- {query.trim().length < 2 - ? 'Type to search...' - : searching - ? 'Searching...' - : searchFailed - ? "Couldn't reach college search — check your connection and try again" - : 'No matching colleges found'} -
- ) : visible.map((c) => ( - - ))} -
- )} -
- ) -} +const FAFSA_TINT = '#1D7FC4' +const CSS_TINT = '#7048C8' +const ADD_SCHOOLS_HREF = formatRoute({ page: 'dashboard', module: 'Application Tracking', tab: 'discover' }) + +const SchoolLine = ({ c, value, color }: { c: AidCollege; value: string; color?: string }) => ( +
+ + {c.name} + {value} +
+) -/* ═══════════════════════════════════════════════════════════════ - TAB: DEADLINES - ═══════════════════════════════════════════════════════════════ */ -const URGENCY_META: Record<'high' | 'medium' | 'low' | 'none', { label: string; color: string; bg: string }> = { - high: { label: 'Act Now', color: '#B93A3A', bg: '#FAEAEA' }, - medium: { label: 'Upcoming', color: '#C47A12', bg: '#F5EDE5' }, - low: { label: 'On Track', color: '#2D9E72', bg: '#EBF5F0' }, - none: { label: 'No dates yet', color: DEADLINE_CLOSED, bg: '#F1EFEA' }, -} +const FormNote = ({ children }: { children: ReactNode }) => ( +

{children}

+) -interface DeadlinesTabProps { - collegeIds: string[] +/** The FAFSA and CSS Profile boxes. In Aid Tracker each opens onto the + * student's schools (Application Tracking's list, plus any saved in the old + * Deadlines tab); on Overview, where they don't open, they go there. */ +export function AidForms({ aid, gradeStartIdx, onSeeSchools }: { aid: AidCollegesState - onAddCollege: (id: string) => void - onRemoveCollege: (id: string) => void - /** Saved in this module, so removable here (not Application Tracking's). */ - removableIds: ReadonlySet - /** The round each Application Tracking school is applied in, by college id. */ - rounds: ReadonlyMap - /** `profiles.grade_start_idx`, which decides whose FAFSA this is. */ gradeStartIdx: number | null | undefined -} - -const DeadlinesTab = ({ collegeIds, aid, onAddCollege, onRemoveCollege, removableIds, rounds, gradeStartIdx }: DeadlinesTabProps) => { - const [open, setOpen] = useState(null) - const { colleges, loading, failed, unresolved } = aid - // The October the student's own FAFSA opens — the same date their calendar - // shows. It was written in as Oct 1, 2026 and "~6 months away" for everyone. + onSeeSchools?: () => void +}) { + const [open, setOpen] = useState<'fafsa' | 'css' | null>(null) const now = new Date() const seniorFall = seniorFallYear(gradeStartIdx, now) - const { date: opens, known } = fafsaOpening(seniorFall) - const opensOn = formatCollegeDate(opens) - const today = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime() - const daysToOpen = Math.round((opens.getTime() - today) / 86_400_000) - // The CSS Profile opens by October 1 each year, sometimes sooner. - const cssOpens = new Date(seniorFall, 9, 1) - return ( -
-

Deadlines

-

- Financial aid deadlines for your college list. Missing a priority deadline can cost thousands in aid. -

- -
- 0 ? `Your FAFSA opens ${known ? '' : 'by '}${opensOn}` : `Your FAFSA opened ${opensOn}`} - body={daysToOpen > 0 - ? `That's ${daysLabel(daysToOpen)}. File as close to opening day as possible for maximum aid. Don't wait until your application deadlines — many school aid funds run out.` - : "It's open now. File as soon as you can — don't wait for your application deadlines, because many school aid funds run out."} - color="#C47A12" - bg="#FFF3E0" - /> + const fafsa = fafsaOpening(seniorFall) + const cssOpens = cssProfileOpening(seniorFall) + // One school can sit on the list under two ids; it shows once. + const schools = [...new Map(aid.colleges.map((c) => [c.canonicalId, inCycle(c, seniorFall)])).values()] + const n = schools.length + + const priority = (c: AidCollege) => parseCollegeDate(c.financialAidDeadlines.fafsaPriority)?.getTime() ?? Infinity + const byPriority = [...schools].sort((a, b) => priority(a) - priority(b) || a.name.localeCompare(b.name)) + const earliest = byPriority.find((c) => priority(c) < Infinity) + const CSS_ORDER: CssNeed[] = ['required', 'check', 'no'] + const byCss = schools.map((c) => ({ c, need: cssNeed(c) })).sort((a, b) => CSS_ORDER.indexOf(a.need) - CSS_ORDER.indexOf(b.need) || a.c.name.localeCompare(b.c.name)) + const required = byCss.filter((x) => x.need === 'required').length + const maybe = byCss.filter((x) => x.need === 'check').length + const ofYour = (k: number) => (n === 1 ? 'your school' : k === n ? `all ${n} of your schools` : `${k} of your ${n} schools`) + + // Until there is a list to read, each box says why not. + const listState = aid.failed ? 'Couldn’t check your schools just now. Your list is saved' + : aid.loading ? 'Checking your schools…' + : n === 0 ? 'Add schools in Application Tracking to see what each one asks for' + : null + const fafsaSummary = listState ?? (earliest + ? `Your earliest school date: ${earliest.financialAidDeadlines.fafsaPriority} (${earliest.name})` + : 'None of your schools has a priority date on file. File when it opens to be safe') + const cssSummary = listState ?? (required + ? `Needed by ${ofYour(required)}${maybe ? `; ${maybe} more may need it` : ''}` + : maybe ? `May be needed by ${ofYour(maybe)}. Check the aid pages` + : `Not needed by ${n === 1 ? 'your school' : `any of your ${n} schools`}`) + + const schoolsBody = (rows: ReactNode) => listState + ? {n === 0 && !aid.loading && !aid.failed ? <>Add schools in Application Tracking to see what each one asks for. : listState} + : <>{aid.unresolved.length > 0 &&
}{rows} + + const box = (id: 'fafsa' | 'css', color: string, title: string, dates: string, summary: string, body: ReactNode) => { + const isOpen = open === id + return ( + // Longhands only, as in AidGuideSections: the shorthand would wipe the colored edge. +
+ + {isOpen &&
{body}
}
+ ) + } -
c.canonicalId)]} onAdd={onAddCollege} placeholder="Search colleges to add to your list..." />
- - {failed ? : loading ? : colleges.length === 0 ? ( -
-
No colleges yet
-
- Search above to add any of the ~6,300 US colleges in our database. Your deadlines and financial aid timelines will appear here. -
-
- ) : ( + return ( +
+ {box('fafsa', FAFSA_TINT, 'FAFSA', + `${fafsa.date <= now ? 'Opened' : fafsa.known ? 'Opens' : 'Opens by'} ${formatCollegeDate(fafsa.date)} · Closes ${formatCollegeDate(fafsaFederalDeadline(seniorFall))}`, + fafsaSummary, <> - {unresolved.length > 0 && } -
- {Object.values(URGENCY_META).map((u) => ( -
- - {u.label} -
- ))} -
- -
- {colleges.map((saved) => { - const col = inCycle(saved, seniorFall) - const round = rounds.get(col.id) ?? rounds.get(col.canonicalId) - const urgency = computeUrgency(col, round) - const urg = URGENCY_META[urgency] - const note = computeDaysNote(col, round) - const isOpen = open === col.id - const earlyDate = col.applicationDeadlines.earlyAction || col.applicationDeadlines.earlyDecision || null - const earlyLabel = col.applicationDeadlines.earlyAction ? 'EA' : col.applicationDeadlines.earlyDecision ? 'ED' : null - // Required by a date or a guarantee; "N/A" only where the school's - // dates were checked by hand. Elsewhere a blank is unknown, and a - // private school may well want it (the same rule as its task list). - const cssRequired = !!col.financialAidDeadlines.cssProfile || !!col.guarantee?.needsCss - const cssDisplay = col.financialAidDeadlines.cssProfile || (cssRequired ? 'Required' : col.curated ? 'N/A' : 'Not on file') - const guarantee = col.guarantee - return ( -
- - - {isOpen && ( -
- {!col.curated && ( -
- We haven't verified deadlines for this school yet. Check its admissions and financial aid pages — - and treat anything blank below as unknown, not as "no deadline". -
- )} -
- {[ - // Only 46 schools have hand-checked dates. For the rest these are - // null, and an empty tile reads as a bug rather than as absent data. - { label: 'App Deadline', value: col.applicationDeadlines.regularDecision ?? '\u2014', note: earlyDate && earlyLabel ? `${earlyLabel}: ${earlyDate}` : null, accent: earlyDate ? '#C47A12' : null }, - // Opening day stood here in the school's date's place. - // It is only the safe stand-in, so it reads as one. - { label: 'FAFSA Priority', value: col.financialAidDeadlines.fafsaPriority ?? 'Not published', note: col.financialAidDeadlines.fafsaPriority ? 'File by this date for best aid' : daysToOpen > 0 ? `To be safe, file when the FAFSA opens (${known ? '' : 'by '}${opensOn})` : `To be safe, file now: the FAFSA opened ${opensOn}`, accent: null }, - { label: 'CSS Profile', value: cssDisplay, note: cssRequired ? 'Required for this school' : !col.curated && !col.isPublic ? 'Check the school’s aid page' : null, accent: cssRequired ? '#B93A3A' : null }, - { label: 'Aid Letter', value: col.financialAidDeadlines.aidNotification ?? '\u2014', note: col.financialAidDeadlines.aidNotification ? 'Estimated notification window' : null, accent: null }, - ].map((d, j) => ( -
-
{d.label}
-
{d.value}
- {d.note &&
{d.note}
} -
- ))} -
- {cssRequired && ( -
- {I.info} - - {col.name} requires the CSS Profile in addition to FAFSA. {cssOpens.getTime() > today ? `It opens by ${formatCollegeDate(cssOpens)}.` : 'It is open now.'} Missing the CSS deadline typically means missing institutional aid entirely. - -
- )} - {col.meetsFullNeed && ( -
- {I.info} - - {col.name} meets 100% of demonstrated financial need{col.noLoanPolicy ? ' with a no-loan policy (grants only)' : ''}. - -
- )} - {/* The school's own aid application is where income guarantees - are won or lost, so every four-year school gets this, not - just the ones with a guarantee on file. Matches the task - list, which gives the aid task to four-year schools only. */} - {(guarantee || col.type === '4-year') &&
- {I.info} - - {guarantee ? ( - <> - {guaranteeLabel(guarantee)}. {guarantee.detail}{' '} - To get it: {guarantee.action}{' '} - Aid page ↗ - - ) : ( - <> - Check {col.name}’s own aid application. Many schools ask for more than the FAFSA — the CSS Profile or their own form — and some promise free tuition below a family income if you file on time. - - )} - -
} - {removableIds.has(col.id) && } -
- )} -
- ) - })} -
- - )} + {schoolsBody(byPriority.map((c) => ))} + + File by each school’s priority date to be first in line for its aid; the federal deadline comes much later. No date on file? File as soon as it opens.{' '} + studentaid.gov ↗ + + )} + {box('css', CSS_TINT, 'CSS Profile', + `${cssOpens <= now ? 'Open now' : `Opens by ${formatCollegeDate(cssOpens)}`} · Each school sets its own due date`, + cssSummary, + <> + {schoolsBody(byCss.map(({ c, need }) => ( + + )))} + + Mostly private colleges use it to award their own aid. Unlike the FAFSA it charges a fee per school, which College Board waives for many lower-income families.{' '} + College Board ↗ + + )}
) } @@ -2297,14 +2104,14 @@ export default function FinancialAidModule({ open, onClose, year = 11, aside }: }, [open, tourSeen]) const isNarrow = useIsNarrow() - // Opens on My Scholarships, as Application Tracking opens on Application + // Opens on Aid Tracker, as Application Tracking opens on Application // Status: a returning student wants to see where each one stands. const [tab, setTab] = useRoutedTab('Financial Aid', open, FA_TAB_IDS, 'scholarships') // A tracked scholarship to open straight onto when switching to My - // Scholarships (from the Aid Engine's strip). Any other tab change clears it. + // Scholarships (from the Scholarship Engine's strip). Any other tab change clears it. const [openScholarship, setOpenScholarship] = useState(null) const switchTab = useCallback((t: TabId) => { setOpenScholarship(null); setTab(t) }, [setTab]) - // Reopens on My Scholarships rather than wherever it was left. The module + // Reopens on Aid Tracker rather than wherever it was left. The module // stays mounted while closed, so the tab would otherwise survive from a // visit the student no longer remembers. Adjusted on the open transition, // not in an effect, so the first paint is already the right tab. @@ -2325,14 +2132,12 @@ export default function FinancialAidModule({ open, onClose, year = 11, aside }: // Scholarships being added, so a double click can't add one twice. const addingRef = useRef(new Set()) const [collegeIds, setCollegeIds] = useState([]) - // Application Tracking's list counts here too, as it does on the calendar; - // the list saved in this module only adds to it. Its schools are removed - // in Application Tracking, so only this module's own ones can be here. + // The schools are Application Tracking's, as on the calendar, plus any a + // student saved in the old Deadlines tab. Those stay shown, though nothing + // here adds to or edits that list any more. const { apps } = useApplications() const shownCollegeIds = useMemo(() => [...new Set([...apps.map((a) => a.collegeId), ...collegeIds])], [apps, collegeIds]) - const removableIds = useMemo(() => new Set(collegeIds.filter((id) => !apps.some((a) => a.collegeId === id))), [apps, collegeIds]) - const rounds = useMemo(() => new Map(apps.map((a) => [a.collegeId, a.deadlineType])), [apps]) - // One lookup for Overview and Deadlines, so moving between them + // One lookup for Overview and Aid Tracker, so moving between them // does not refetch the same rows. Each opening of the module is its own // session, so reopening fetches fresh rather than showing last visit's rows. const [openCount, setOpenCount] = useState(0) @@ -2432,7 +2237,7 @@ export default function FinancialAidModule({ open, onClose, year = 11, aside }: .then((ids) => { if (!cancelled) setCollegeIds(ids) }) .catch(noteFailure) - // The Aid Engine's catalogue, fetched now alongside the rest. Asked for by + // The Scholarship Engine's catalogue, fetched now alongside the rest. Asked for by // the tab itself, it waited for the saved preferences to load first, and // the round trips in series kept matches from showing for seconds. Cached // in fafsaData; the tab reports a failure when it asks. @@ -2455,19 +2260,6 @@ export default function FinancialAidModule({ open, onClose, year = 11, aside }: } } - const handleAddCollege = async (id: string) => { - if (collegeIds.includes(id)) return - const next = [...collegeIds, id] - setCollegeIds(next) - try { await saveCollegeList(next) } catch { setCollegeIds(collegeIds); toast.error('Could not update your college list — try again') } - } - - const handleRemoveCollege = async (id: string) => { - const next = collegeIds.filter((x) => x !== id) - setCollegeIds(next) - try { await saveCollegeList(next) } catch { setCollegeIds(collegeIds); toast.error('Could not update your college list — try again') } - } - // Optimistic edits put back only the item they touched on failure, so a // second edit made meanwhile isn't undone with it. const restore = (item: DBTrackerItem) => setTracker((prev) => prev.map((t) => (t.id === item.id ? item : t))) @@ -2514,7 +2306,7 @@ export default function FinancialAidModule({ open, onClose, year = 11, aside }: scholarshipId: s.id, }) setTracker((prev) => [item, ...prev]) - toast.success('Added to My Scholarships') + toast.success('Added to Aid Tracker') } catch { toast.error('Could not add — try again') } @@ -2524,7 +2316,7 @@ export default function FinancialAidModule({ open, onClose, year = 11, aside }: try { const item = await addTrackerItem(input) setTracker((prev) => [item, ...prev]) - toast.success('Added to My Scholarships') + toast.success('Added to Aid Tracker') return true } catch { toast.error('Could not add — try again') @@ -2543,7 +2335,7 @@ export default function FinancialAidModule({ open, onClose, year = 11, aside }: setTracker((prev) => prev.filter((t) => t.id !== id)) try { await removeTrackerItem(id) - toast.info('Removed from My Scholarships') + toast.info('Removed from Aid Tracker') } catch { // Put it back where it was, keeping anything else changed meanwhile. const item = snapshot.find((t) => t.id === id) @@ -2566,9 +2358,9 @@ export default function FinancialAidModule({ open, onClose, year = 11, aside }: const content = tab === 'overview' ? : - tab === 'scholarships' ? switchTab('scholarship-search')} /> : - tab === 'scholarship-search' ? void saveAidPrefsOrSay(p)} dismissals={dismissals} onOpenTracked={openTracked} year={year} /> : - + tab === 'scholarships-101' ? : + tab === 'scholarships' ? switchTab('scholarship-search')} /> : + void saveAidPrefsOrSay(p)} dismissals={dismissals} onOpenTracked={openTracked} year={year} /> return (
diff --git a/web/src/components/contentBlocks.tsx b/web/src/components/contentBlocks.tsx index a2e3fdb..c6c892e 100644 --- a/web/src/components/contentBlocks.tsx +++ b/web/src/components/contentBlocks.tsx @@ -8,7 +8,7 @@ * they convey semantic state, not module identity. */ -import { useCallback, useState } from 'react' +import { useCallback, useState, type ReactNode } from 'react' import { C, SUCCESS_GREEN } from '../lib/designTokens' import type { ContentBlock, QuizQuestion } from '../data/checklistContent' import { CALLOUT_VARIANT } from './contentBlocks.constants' @@ -187,10 +187,22 @@ export function QuizBlock({ questions, accentColor }: { questions: QuizQuestion[ ) } +/** A block's **bold** and *italic* runs. The split's captures land at odd indexes. */ +function inline(text: string): ReactNode { + return text.split(/(\*\*[^*]+\*\*|\*[^*]+\*)/).map((part, i) => + i % 2 === 0 ? part + : part.startsWith('**') ? {part.slice(2, -2)} + : {part.slice(1, -1)}) +} + export function ContentBlockRenderer({ block, accentColor }: { block: ContentBlock; accentColor: string }) { switch (block.kind) { case 'heading': - return ( + return block.level === 3 ? ( +

+ {block.text} +

+ ) : (

{block.text}

@@ -198,19 +210,47 @@ export function ContentBlockRenderer({ block, accentColor }: { block: ContentBlo case 'paragraph': return (

- {block.text} + {inline(block.text)}

) - case 'list': + case 'list': { + const List = block.ordered ? 'ol' : 'ul' return ( -
    + {block.items.map((item, i) => (
  • - - {item} + {block.ordered + ? {i + 1}. + : } + {inline(item)}
  • ))} -
+ + ) + } + case 'table': + return ( + // Scrolls inside itself on a phone rather than widening the page. +
+ + + + {block.head.map((h, i) => ( + + ))} + + + + {block.rows.map((row, r) => ( + + {row.map((cell, c) => ( + + ))} + + ))} + +
{h}
{inline(cell)}
+
) case 'callout': { const v = CALLOUT_VARIANT[block.variant] ?? CALLOUT_VARIANT.info @@ -224,7 +264,7 @@ export function ContentBlockRenderer({ block, accentColor }: { block: ContentBlo {block.title}
- {block.text} + {inline(block.text)}
diff --git a/web/src/data/aidPrograms.ts b/web/src/data/aidPrograms.ts index 5f2030c..3e805ea 100644 --- a/web/src/data/aidPrograms.ts +++ b/web/src/data/aidPrograms.ts @@ -176,7 +176,7 @@ export const SCHOLARSHIP_CATEGORIES: ScholarshipCategory[] = [ id: 'specialized', name: 'Specialized', description: 'For particular groups or paths: STEM, first-generation students, students of color, or a specific major.', - example: 'Check the Aid Engine for ones that fit you', + example: 'Check the Scholarship Engine for ones that fit you', }, ] diff --git a/web/src/data/applicationDeadlines.ts b/web/src/data/applicationDeadlines.ts index fc6b2fd..93da026 100644 --- a/web/src/data/applicationDeadlines.ts +++ b/web/src/data/applicationDeadlines.ts @@ -488,6 +488,12 @@ export function fafsaOpening(seniorFall: number): { date: Date; known: boolean } : { date: new Date(seniorFall, 9, 1), known: false } } +/** The last day a cycle's FAFSA is taken: June 30 at the end of its aid year. */ +export const fafsaFederalDeadline = (seniorFall: number) => new Date(seniorFall + 2, 5, 30) + +/** College Board opens the CSS Profile "starting October 1 each year", sometimes sooner. */ +export const cssProfileOpening = (seniorFall: number) => new Date(seniorFall, 9, 1) + /** * The aid forms' dates: the FAFSA and CSS Profile windows, each school's own * priority dates for them, and the home state's grant deadline. @@ -532,7 +538,7 @@ function deriveAidEvents( link: 'https://studentaid.gov/h/apply-for-aid/fafsa', }) - const federal = new Date(seniorFall + 2, 5, 30) + const federal = fafsaFederalDeadline(seniorFall) events.push({ ...base, id: 'fafsa-federal', @@ -636,8 +642,7 @@ function deriveAidEvents( } if (cssSchools.length > 0) { - // College Board opens it "starting October 1 each year", sometimes sooner. - const cssOpens = new Date(seniorFall, 9, 1) + const cssOpens = cssProfileOpening(seniorFall) events.push({ ...base, id: 'css-opens', diff --git a/web/src/data/checklistContent.ts b/web/src/data/checklistContent.ts index 6b9cd12..f90c184 100644 --- a/web/src/data/checklistContent.ts +++ b/web/src/data/checklistContent.ts @@ -11,10 +11,12 @@ export interface QuizQuestion { explanation: string } +/** Text in paragraphs, lists, callouts and tables may mark **bold** and *italic*. */ export type ContentBlock = | { kind: 'paragraph'; text: string } - | { kind: 'heading'; text: string } - | { kind: 'list'; items: string[] } + | { kind: 'heading'; text: string; level?: 3 } + | { kind: 'list'; items: string[]; ordered?: boolean } + | { kind: 'table'; head: string[]; rows: string[][] } | { kind: 'callout'; title: string; text: string; variant: 'info' | 'tip' | 'warning' } | { kind: 'quiz'; questions: QuizQuestion[] } | { kind: 'checklist'; title: string; items: string[] } @@ -581,8 +583,291 @@ export const CHECKLIST_CONTENT: ChecklistContent[] = [ }, /* ───────────────────────────────────────────────────────────── - SECTION 3: Scholarship Research + SECTION 3: Scholarships 101 — its own tab, in the content team's + reading order (Edvifi Content, 2026-10-30) ───────────────────────────────────────────────────────────── */ + { + id: 'sr-5', + title: 'Understanding Scholarships: Types, Eligibility, and How They Work', + type: 'article', + body: [ + { kind: 'heading', text: 'What Is a Scholarship?' }, + { + kind: 'paragraph', + text: 'College can be expensive, but you don\'t necessarily have to pay for everything yourself. Scholarships are one of the best ways to make college more affordable because **they provide money for your education that you generally don\'t have to pay back.**', + }, + { + kind: 'paragraph', + text: 'Unlike student loans, scholarships don\'t leave you with debt after graduation. Some scholarships cover a few hundred dollars, while others can pay for your entire tuition, housing, and other college expenses.', + }, + { + kind: 'paragraph', + text: 'And here\'s something important: **You don\'t need perfect grades or an impressive résumé to qualify for scholarships.** There are scholarships for students with different academic abilities, financial circumstances, interests, backgrounds, and career goals.', + }, + { + kind: 'paragraph', + text: 'The key is understanding what kinds of scholarships are available and which ones might be right for you.', + }, + { kind: 'heading', text: 'Scholarships, Grants, and Loans: What\'s the Difference?' }, + { + kind: 'paragraph', + text: 'When researching how to pay for college, you\'ll come across several types of financial aid. They might sound similar, but they work differently.', + }, + { + kind: 'table', + head: ['Type of Aid', 'What It Means', 'Do You Pay It Back?'], + rows: [ + ['Scholarships', 'Money awarded based on financial need, academic achievement, interests, background, or other criteria', 'Usually no'], + ['Grants', 'Financial aid often awarded based on financial need, such as the federal Pell Grant', 'Usually no'], + ['Student Loans', 'Money you borrow to pay for college', 'Yes, generally with interest'], + ['Work-Study', 'Money you earn through an eligible part-time job while attending college', 'No, because it\'s earned income'], + ], + }, + { + kind: 'callout', + title: 'Edvifi Tip: Start With Free Money', + text: 'Before considering student loans, explore scholarships and grants. They can reduce how much you need to borrow and how much you\'ll owe after graduation. Remember that completing the FAFSA is one of the most important steps in accessing financial aid, including federal grants and certain scholarships offered by colleges.', + variant: 'tip', + }, + { kind: 'heading', text: 'The Different Types of Scholarships' }, + { + kind: 'paragraph', + text: 'Not all scholarships work the same way. Understanding the different categories can help you find opportunities that match your circumstances.', + }, + { kind: 'heading', level: 3, text: '1. Need-Based Scholarships' }, + { + kind: 'paragraph', + text: 'These scholarships are intended for students who demonstrate financial need.', + }, + { + kind: 'paragraph', + text: 'Eligibility may depend on your family\'s income, household circumstances, or other financial information. Some scholarships require you to complete the FAFSA or submit additional financial documents.', + }, + { + kind: 'paragraph', + text: 'You don\'t necessarily have to come from a very low-income household to qualify. Different programs have different eligibility standards.', + }, + { kind: 'heading', level: 3, text: '2. Merit-Based Scholarships' }, + { + kind: 'paragraph', + text: 'Merit scholarships recognize achievements, talents, or accomplishments.', + }, + { + kind: 'paragraph', + text: 'These can include:', + }, + { + kind: 'list', + items: [ + 'Academic performance or GPA', + 'Leadership and community service', + 'Artistic or musical talent', + 'Athletic achievement', + 'Accomplishments in specific subjects or activities', + ], + }, + { + kind: 'paragraph', + text: 'While some merit scholarships are highly competitive, others have more accessible requirements.', + }, + { kind: 'heading', level: 3, text: '3. Identity, Background, and Interest-Based Scholarships' }, + { + kind: 'paragraph', + text: 'Many organizations offer scholarships to support students with particular backgrounds, experiences, interests, or career goals.', + }, + { + kind: 'paragraph', + text: 'For example, scholarships may be available for:', + }, + { + kind: 'list', + items: [ + 'First-generation college students', + 'Students pursuing specific majors or careers', + 'Students from particular communities or geographic areas', + 'Students with disabilities', + 'Students involved in community service or leadership', + 'Children of employees of certain companies or organizations', + ], + }, + { + kind: 'paragraph', + text: 'You may qualify for scholarships based on experiences or interests you haven\'t considered particularly unusual.', + }, + { + kind: 'paragraph', + text: '**Remember:** You can qualify for multiple categories of scholarships at the same time. For example, you might be eligible for a need-based scholarship, a local community scholarship, and a scholarship related to your intended major.', + }, + { kind: 'heading', text: 'Where Does Scholarship Money Come From?' }, + { + kind: 'paragraph', + text: 'Scholarships can come from several different sources, and knowing where to look is just as important as knowing what you qualify for.', + }, + { kind: 'heading', level: 3, text: 'Scholarships From Colleges' }, + { + kind: 'paragraph', + text: 'Many colleges offer scholarships directly to their students. These are called *institutional scholarships*.', + }, + { + kind: 'paragraph', + text: 'Some colleges automatically consider students for certain scholarships when they apply for admission. Others require separate scholarship applications, essays, interviews, or earlier application deadlines.', + }, + { + kind: 'paragraph', + text: 'Colleges may offer scholarships based on academic achievement, financial need, leadership, intended major, or other qualifications.', + }, + { + kind: 'paragraph', + text: '**Important:** Don\'t assume that submitting your college application automatically qualifies you for every scholarship the school offers. Always check the college\'s financial aid and scholarship website for additional requirements.', + }, + { kind: 'heading', level: 3, text: 'State and Local Scholarships' }, + { + kind: 'paragraph', + text: 'State governments, community foundations, school districts, local businesses, and civic organizations may offer scholarships to students in their communities.', + }, + { + kind: 'paragraph', + text: 'Some are available only to residents of a particular state, county, or school district.', + }, + { + kind: 'paragraph', + text: 'Because these scholarships may have smaller applicant pools than major national programs, they can be worth prioritizing.', + }, + { kind: 'heading', level: 3, text: 'National and Private Scholarships' }, + { + kind: 'paragraph', + text: 'National scholarships are offered by foundations, nonprofits, corporations, and other organizations.', + }, + { + kind: 'paragraph', + text: 'Some are open to students across the country, while others target particular academic interests, backgrounds, or career paths.', + }, + { + kind: 'paragraph', + text: 'National scholarships can offer substantial funding, but some are also highly competitive.', + }, + { + kind: 'paragraph', + text: 'A strong scholarship strategy includes exploring opportunities from multiple sources rather than focusing exclusively on one category.', + }, + { kind: 'heading', text: 'One-Time vs. Renewable Scholarships' }, + { + kind: 'paragraph', + text: 'When comparing scholarships, don\'t just look at the amount advertised. Pay attention to **how often you\'ll receive the money**.', + }, + { + kind: 'paragraph', + text: 'Some scholarships provide a one-time payment. Others are renewable, meaning you can receive funding for multiple years if you continue meeting the requirements.', + }, + { + kind: 'paragraph', + text: 'For example:', + }, + { + kind: 'table', + head: ['', 'Scholarship A', 'Scholarship B'], + rows: [ + ['Award amount', '$5,000', '$2,000 per year'], + ['Duration', 'One year', 'Up to four years'], + ['Total potential value', '$5,000', '$8,000'], + ['Renewal requirements', 'None', 'Maintain required GPA'], + ], + }, + { + kind: 'paragraph', + text: 'Even though Scholarship A offers more money initially, Scholarship B could provide more funding over the course of college.', + }, + { + kind: 'paragraph', + text: 'Renewable scholarships may require you to maintain a minimum GPA, enroll full-time, continue in a particular major, or meet other conditions.', + }, + { + kind: 'paragraph', + text: 'Before accepting an award, make sure you understand its requirements.', + }, + { kind: 'heading', text: 'Can You Receive More Than One Scholarship?' }, + { + kind: 'paragraph', + text: '**Yes!** Students can often receive multiple scholarships from different organizations.', + }, + { + kind: 'paragraph', + text: 'For example, you might receive:', + }, + { + kind: 'list', + items: [ + 'A $3,000 scholarship from your college', + 'A $1,500 scholarship from a local community foundation', + 'A $2,000 scholarship from a national organization', + ], + }, + { + kind: 'paragraph', + text: 'Together, that\'s $6,500 in scholarship awards.', + }, + { + kind: 'paragraph', + text: 'However, there\'s an important detail: receiving an outside scholarship can sometimes affect the financial aid your college offers.', + }, + { + kind: 'paragraph', + text: 'Colleges generally have to account for outside scholarships when determining your total financial aid package. Depending on the school\'s policies and your existing aid, an outside scholarship might reduce your remaining costs, replace some loans or work-study, or reduce certain institutional grants.', + }, + { + kind: 'callout', + title: 'Edvifi Tip: Check Before You Count', + text: 'If you receive an outside scholarship, contact your college\'s financial aid office and ask how it will affect your financial aid package. Don\'t assume every additional scholarship will reduce your college bill by the full award amount.', + variant: 'tip', + }, + { kind: 'heading', text: 'What Can Scholarships Pay For?' }, + { + kind: 'paragraph', + text: 'Scholarships aren\'t always limited to tuition.', + }, + { + kind: 'paragraph', + text: 'Depending on the scholarship\'s rules, funds may be used for:', + }, + { + kind: 'list', + items: [ + 'Tuition and required fees', + 'Textbooks and course materials', + 'Housing and meals', + 'Computers and other educational supplies', + 'Other eligible education-related expenses', + ], + }, + { + kind: 'paragraph', + text: 'Some scholarships send money directly to your college, while others pay students or reimburse approved expenses.', + }, + { + kind: 'paragraph', + text: 'Always check how the scholarship can be used. Certain awards are restricted to tuition or specific educational costs, and some scholarship funds may have tax implications depending on how they\'re used.', + }, + { kind: 'heading', text: 'Your Next Step: Start Finding Scholarships' }, + { + kind: 'paragraph', + text: 'Now that you understand how scholarships work, you\'re ready to start looking for opportunities that fit your goals and circumstances.', + }, + { + kind: 'paragraph', + text: 'You don\'t have to qualify for every scholarship, and you don\'t have to apply to hundreds of them.', + }, + { + kind: 'paragraph', + text: 'The goal is to find scholarships you\'re genuinely eligible for, understand what they\'re worth, and build a manageable application plan.', + }, + { + kind: 'callout', + title: 'Up Next: How to Find Scholarships You Actually Qualify For', + text: 'You\'ll learn where to search, how to identify scholarships that match your background and interests, and how to avoid wasting time on opportunities that aren\'t right for you.', + variant: 'info', + }, + ], + }, { id: 'sr-1', title: 'How to Find Scholarships You Actually Qualify For', @@ -591,55 +876,388 @@ export const CHECKLIST_CONTENT: ChecklistContent[] = [ { kind: 'heading', text: 'Cutting Through the Noise' }, { kind: 'paragraph', - text: 'There are literally millions of scholarships out there, which sounds great — until you realize that most of them have very specific eligibility requirements. The key isn\'t to apply to hundreds of scholarships blindly. It\'s to find the ones that align with who you are, what you do, and where you live. A targeted approach saves time and dramatically improves your odds.', + text: 'There are thousands of scholarships available to help students pay for college. But with so many opportunities, finding the right ones can feel overwhelming.', + }, + { + kind: 'paragraph', + text: 'Here\'s the good news: **You don\'t need to apply to every scholarship you find.** The key is identifying opportunities that match your background, interests, achievements, and goals.', + }, + { + kind: 'paragraph', + text: 'Instead of spending hours applying to scholarships you might not qualify for, focus on finding ones where you meet the requirements and can put together a strong application.', + }, + { + kind: 'paragraph', + text: 'A targeted approach can save you time and help you make the most of your scholarship search.', + }, + { kind: 'heading', text: 'Start With What Makes You Unique' }, + { + kind: 'paragraph', + text: 'Scholarships aren\'t just for students with perfect grades or impressive extracurricular activities. Many organizations offer scholarships to students based on their experiences, interests, and circumstances.', + }, + { + kind: 'paragraph', + text: 'Before you start searching, think about what makes you eligible for different opportunities:', + }, + { + kind: 'list', + items: [ + '**Where you live:** Your state, county, city, or school district.', + '**Your academic interests:** Your intended college major, favorite subjects, or career goals.', + '**Your activities and experiences:** Extracurriculars, volunteering, community service, leadership, hobbies, or part-time jobs.', + '**Your background:** First-generation college status, cultural background, or other characteristics relevant to eligibility.', + '**Your financial circumstances:** Some scholarships are specifically intended for students from low-income or financially disadvantaged households.', + '**Your family\'s connections:** Your parents\' or guardians\' employers, labor unions, military service, or professional organizations.', + '**Your community affiliations:** Religious, cultural, or community organizations you belong to.', + '**Other circumstances:** Disabilities, health conditions, caregiving responsibilities, or other life experiences.', + ], + }, + { + kind: 'callout', + title: 'Edvifi Tip: Think Beyond Your GPA', + text: 'You might qualify for scholarships based on experiences you haven\'t considered particularly special. For example, working a part-time job to support your family, volunteering at a local organization, or being the first in your family to attend college could make you eligible for certain scholarships.', + variant: 'tip', + }, + { kind: 'heading', text: 'Where to Search' }, + { + kind: 'paragraph', + text: 'You don\'t have to figure out where to look on your own. Here are some of the best places to start:', + }, + { + kind: 'list', + items: [ + '**Your prospective colleges:** Visit each college\'s financial aid and scholarship website. Some scholarships are awarded automatically, while others require separate applications.', + '**Your school counselor:** Counselors often maintain lists of local scholarships, including opportunities specifically for students at your high school.', + '**Scholarship search engines:** Websites like Fastweb, Scholarships.com, Bold.org, and College Board\'s scholarship search tools can help you discover opportunities.', + '**Your state\'s higher education agency:** Many states offer scholarships and grants for eligible residents.', + '**Community foundations:** Search "[your county] community foundation scholarships" to find opportunities in your area.', + '**Local organizations and businesses:** Rotary Clubs, Lions Clubs, banks, community groups, and other organizations may offer scholarships.', + '**Professional associations:** Organizations connected to fields like engineering, healthcare, education, or public service sometimes fund scholarships for future professionals.', + '**Your family\'s employers or unions:** Some employers and labor organizations offer scholarships for employees\' children or dependents.', + ], + }, + { + kind: 'callout', + title: 'Edvifi Tip: Start With Your College List', + text: 'Before spending hours searching national scholarship websites, check the scholarships offered by colleges you\'re already planning to apply to. Some schools have important priority deadlines or separate scholarship applications. Missing those deadlines could mean missing out on significant financial aid.', + variant: 'tip', + }, + { kind: 'heading', text: 'Check Whether You Actually Qualify' }, + { + kind: 'paragraph', + text: 'Finding a scholarship that sounds interesting is only the first step. Before spending time on an application, make sure you meet its eligibility requirements.', + }, + { + kind: 'paragraph', + text: 'Pay attention to:', + }, + { + kind: 'list', + items: [ + '**Grade level:** Is the scholarship open to high school seniors, current college students, or both?', + '**GPA:** Does it require a minimum GPA?', + '**Location:** Do you need to live in a particular state, county, or school district?', + '**Financial need:** Does the scholarship have income requirements or require financial documentation?', + '**Academic interests:** Do you need to pursue a specific major or career?', + '**Other requirements:** Does the scholarship require community service, particular activities, or other qualifications?', + '**Deadline:** Is the scholarship still accepting applications?', + ], + }, + { + kind: 'paragraph', + text: 'Some scholarships also require you to attend a specific college or maintain certain qualifications after receiving the award.', + }, + { kind: 'heading', level: 3, text: 'Before You Apply' }, + { + kind: 'paragraph', + text: 'Ask yourself three questions:', + }, + { + kind: 'list', ordered: true, + items: [ + 'Do I meet all the required eligibility criteria?', + 'Can I complete the application before the deadline?', + 'Is this scholarship worth the time and effort required to apply?', + ], + }, + { + kind: 'paragraph', + text: 'If the answer to all three is yes, it may be a good opportunity to add to your scholarship tracker.', + }, + { kind: 'heading', text: 'Don\'t Overlook Smaller Scholarships' }, + { + kind: 'paragraph', + text: 'It\'s easy to get excited about scholarships offering $10,000, $20,000, or even a full ride. But smaller scholarships can be valuable too.', + }, + { + kind: 'paragraph', + text: 'Local and specialized scholarships sometimes attract fewer applicants than major national awards, which may improve your chances of receiving funding.', + }, + { + kind: 'paragraph', + text: 'For example, imagine two scholarships:', + }, + { + kind: 'list', + items: [ + '**Scholarship A:** $10,000 award with 10,000 applicants.', + '**Scholarship B:** $1,000 award with 50 applicants.', + ], + }, + { + kind: 'paragraph', + text: 'Although Scholarship A offers more money, Scholarship B has a much smaller applicant pool. That doesn\'t guarantee better odds, since the number of awards and selection criteria also matter, but it illustrates why smaller opportunities deserve attention.', + }, + { + kind: 'paragraph', + text: 'And remember: **Scholarship money adds up.** Winning several smaller scholarships can make a meaningful difference in your college expenses.', + }, + { kind: 'heading', text: 'Red Flags to Watch For' }, + { + kind: 'paragraph', + text: 'Unfortunately, scholarship scams exist. Be cautious when researching opportunities online.', + }, + { + kind: 'paragraph', + text: 'Watch out for:', + }, + { + kind: 'list', + items: [ + '**Application fees:** Be suspicious of scholarship programs that require you to pay money to apply or claim an award.', + '**Guaranteed awards:** No legitimate competitive scholarship can promise you\'ll win before evaluating your application.', + '**Requests for sensitive financial information:** Be careful about sharing bank account details, credit card information, or Social Security numbers through unfamiliar websites.', + '**Upfront tax payments:** A scholarship provider should not demand that you pay taxes or processing fees upfront to receive your award.', + '**Unclear organizations:** If you can\'t identify who funds the scholarship or find reliable information about the organization, investigate before applying.', + ], + }, + { + kind: 'paragraph', + text: 'Some legitimate scholarship programs request sensitive information for eligibility verification or award administration. Always confirm that you\'re communicating through the organization\'s official website or verified channels.', + }, + { + kind: 'callout', + title: 'Edvifi Tip: Verify Before You Apply', + text: 'If a scholarship seems suspicious, ask your school counselor for help or research the organization offering it. Never feel pressured to send money or sensitive personal information to claim a scholarship.', + variant: 'tip', + }, + { kind: 'heading', text: 'Your Next Step: Start Building Your Scholarship List' }, + { + kind: 'paragraph', + text: 'Now that you know where to search and how to evaluate eligibility, it\'s time to put those strategies into practice.', + }, + { + kind: 'paragraph', + text: 'You don\'t need to find dozens of scholarships all at once. Start with a few opportunities that genuinely match your qualifications.', + }, + { + kind: 'paragraph', + text: 'As you discover scholarships, save them in Aid Tracker so you can keep track of deadlines, application requirements, and next steps.', + }, + { + kind: 'callout', + title: 'Up Next: Local vs. National Scholarships: Where to Start', + text: 'Learn how to balance local, specialized, and national scholarship opportunities to build a scholarship list that works for you.', + variant: 'info', + }, + ], + }, + { + id: 'sr-3', + title: 'Local vs. National Scholarships: Where to Start', + type: 'article', + body: [ + { kind: 'heading', text: 'The Case for Starting Local' }, + { + kind: 'paragraph', + text: 'When most people think about scholarships, they picture big national programs like the Gates Scholarship or Coca-Cola Scholars. These scholarships can offer substantial financial support, but they also attract applicants from across the country, making them highly competitive.', + }, + { + kind: 'paragraph', + text: 'Local scholarships can offer a different kind of opportunity.', + }, + { + kind: 'paragraph', + text: 'Community foundations, local businesses, civic organizations, and school districts often provide scholarships specifically for students in their communities. Because fewer students may be eligible to apply, these scholarships sometimes have smaller applicant pools than major national programs.', + }, + { + kind: 'paragraph', + text: 'And here\'s something worth remembering: **You don\'t need to win one enormous scholarship to make a difference in your college costs.**', + }, + { + kind: 'paragraph', + text: 'For example, winning five $1,000 scholarships would give you $5,000 toward college expenses. That\'s money you may not have to borrow or pay out of pocket, depending on how your college applies outside scholarships to your financial aid package.', + }, + { + kind: 'paragraph', + text: 'Smaller scholarships can add up, so don\'t overlook them just because the award amounts seem modest.', + }, + { + kind: 'callout', + title: 'Edvifi Tip: Smaller Doesn\'t Mean Less Valuable', + text: 'A $1,000 scholarship with a straightforward application might be worth prioritizing over a $10,000 scholarship requiring multiple essays, interviews, and recommendations. Consider how well you meet the requirements, how competitive the scholarship is, and how much time you\'ll need to apply—not just the award amount.', + variant: 'tip', + }, + { kind: 'heading', text: 'Where to Find Local Scholarships' }, + { + kind: 'paragraph', + text: 'You might be surprised by how many scholarship opportunities exist in your own community.', + }, + { + kind: 'paragraph', + text: 'Some good places to start include:', + }, + { + kind: 'list', + items: [ + '**Your high school counseling office:** Counselors often maintain lists of scholarships specifically for students at your school or in your district.', + '**Community foundations:** Search "[your county] community foundation scholarships" to find organizations offering scholarships to local students.', + '**Civic organizations:** Rotary Clubs, Kiwanis, Lions Clubs, Elks Lodges, and similar organizations sometimes sponsor scholarships.', + '**Local businesses:** Banks, law firms, medical practices, and other businesses may offer scholarships to students in their communities.', + '**Your parents\' or guardians\' employers:** Some companies and labor unions offer scholarships for employees\' children or dependents.', + '**Religious and community organizations:** Churches, mosques, synagogues, temples, and cultural organizations may offer scholarships to eligible students.', + '**Your school district or PTA:** Some districts and parent-teacher organizations provide scholarships for graduating seniors.', + '**Local newspapers and community websites:** These may advertise scholarship opportunities that aren\'t listed on major scholarship search engines.', + ], + }, + { + kind: 'paragraph', + text: '**Try This:** Search for scholarships using your city, county, or school district alongside terms like "high school senior scholarship" or "community foundation scholarship."', + }, + { + kind: 'paragraph', + text: 'You may discover opportunities that students searching only national scholarship websites would miss.', + }, + { kind: 'heading', text: 'When National Scholarships Make Sense' }, + { + kind: 'paragraph', + text: 'National scholarships are absolutely worth exploring, especially when you meet their eligibility requirements and have a strong application.', + }, + { + kind: 'paragraph', + text: 'Some national programs offer awards that cover a significant portion of college expenses. Others provide smaller amounts but are designed for students with particular interests, backgrounds, or career goals.', + }, + { + kind: 'paragraph', + text: 'The key is to be selective.', }, - { kind: 'heading', text: 'Start With What Makes You Unique' }, { kind: 'paragraph', - text: 'Scholarships exist for almost every background, interest, and circumstance. Before searching, make a list of your characteristics that scholarship committees look for:', + text: 'Prioritize national scholarships that:', }, { kind: 'list', items: [ - 'Your demographic background (ethnicity, gender, first-generation college student)', - 'Where you live (state, county, city — local scholarships have less competition)', - 'Your parents\' employers (many companies offer dependent scholarships)', - 'Your intended major or career field', - 'Your extracurricular activities, community service, or leadership roles', - 'Religious affiliation, if any', - 'Health conditions or disabilities', - 'Military connection (veterans, active duty family members)', + '**Match your background or experiences:** Look for scholarships designed for students with qualifications or experiences that align with yours.', + '**Connect to your interests or goals:** Scholarships focused on STEM, the arts, education, healthcare, public service, or other fields may be a good fit.', + '**Have specific eligibility requirements:** Specialized scholarships may attract a narrower applicant pool than programs open to nearly everyone.', + '**Offer meaningful financial support:** Consider the award amount, whether it\'s renewable, and how it could affect your college costs.', + '**Fit your schedule:** Make sure you have enough time to complete a strong application before the deadline.', + ], + }, + { + kind: 'callout', + title: 'Edvifi Tip: Make Your Work Go Further', + text: 'Many scholarship applications ask similar questions about your goals, accomplishments, challenges, or community involvement. You can often reuse ideas or adapt essays from previous applications. Just make sure each response answers the specific prompt and reflects what that scholarship organization is looking for.', + variant: 'tip', + }, + { kind: 'heading', text: 'How to Decide Which Scholarships to Prioritize' }, + { + kind: 'paragraph', + text: 'Not every scholarship deserves the same amount of your time.', + }, + { + kind: 'paragraph', + text: 'When comparing opportunities, consider these four factors:', + }, + { + kind: 'table', + head: ['Factor', 'Questions to Ask'], + rows: [ + ['Eligibility', 'Do I meet all the requirements?'], + ['Award Value', 'How much funding could I receive? Is it renewable?'], + ['Application Effort', 'How much time will the essays, recommendations, and other requirements take?'], + ['Competitiveness', 'How selective is the scholarship, and how well do I match its criteria?'], ], }, - { kind: 'heading', text: 'Where to Search' }, + { + kind: 'paragraph', + text: 'For example, imagine you\'re considering two scholarships:', + }, + { kind: 'heading', level: 3, text: 'Scholarship A: National Leadership Scholarship' }, { kind: 'list', items: [ - 'Your school counselor — they often maintain a local scholarship list that gets updated throughout the year', - 'Scholarship search engines — Fastweb, Scholarships.com, Bold.org, College Board Scholarship Search', - 'Your state\'s higher education agency — many states offer merit and need-based scholarships', - 'Community organizations — Rotary Club, Lions Club, Elks Lodge, local businesses', - 'Professional associations related to your intended career', - 'Your parents\' workplaces, unions, or professional organizations', - 'Your community foundation (search "[your county] community foundation scholarships")', + 'Award: $10,000', + 'Open to students nationwide', + 'Requires three essays and two recommendation letters', + 'Highly competitive', ], }, + { kind: 'heading', level: 3, text: 'Scholarship B: Local Community Service Scholarship' }, { - kind: 'callout', - title: 'The Sweet Spot', - text: 'Local and niche scholarships typically have fewer applicants, making your odds much better. A $1,000 local scholarship with 50 applicants is far more attainable than a $10,000 national scholarship with 50,000 applicants. Apply to both, but don\'t ignore the smaller ones.', - variant: 'tip', + kind: 'list', + items: [ + 'Award: $1,500', + 'Open to graduating seniors in your county', + 'Requires one short essay', + 'Prioritizes students with community service experience', + ], + }, + { + kind: 'paragraph', + text: 'If you\'ve volunteered regularly in your community, Scholarship B might be an especially good opportunity. You meet its focus, the application is manageable, and the applicant pool may be smaller.', + }, + { + kind: 'paragraph', + text: 'That doesn\'t mean you should skip Scholarship A. It means you should think strategically about where to invest your time.', + }, + { kind: 'heading', text: 'The Ideal Strategy: Build a Balanced Scholarship List' }, + { + kind: 'paragraph', + text: 'You don\'t have to choose between local and national scholarships. A strong scholarship list can include both.', + }, + { + kind: 'paragraph', + text: 'Consider building your list around three categories:', }, - { kind: 'heading', text: 'Red Flags to Watch For' }, { kind: 'list', items: [ - 'Never pay an application fee for a scholarship — legitimate scholarships don\'t charge you to apply', - 'Be wary of "guaranteed" scholarships or prizes — real scholarships are competitive', - 'Don\'t give out bank account or credit card information', - 'Legitimate scholarships won\'t ask you to pay taxes upfront on winnings', + '**Local scholarships:** Opportunities available through your school, community, or region. These may have smaller applicant pools and more specific eligibility requirements.', + '**Specialized scholarships:** Opportunities that closely match your background, interests, achievements, or intended career.', + '**National scholarships:** Larger or more competitive programs that offer meaningful funding and align with your qualifications.', ], }, + { + kind: 'paragraph', + text: 'There\'s no perfect number of scholarships to apply for in each category. What matters most is finding opportunities you\'re eligible for and can realistically complete.', + }, + { + kind: 'callout', + title: 'Remember: Quality Matters More Than Quantity', + text: 'Applying to dozens of scholarships without checking eligibility or putting effort into your applications isn\'t necessarily better than submitting a smaller number of thoughtful, well-prepared applications. Start with opportunities that are a strong fit, then expand your list as time allows.', + variant: 'info', + }, + { kind: 'heading', text: 'Your Next Step: Build Your Scholarship Tracker' }, + { + kind: 'paragraph', + text: 'Now that you know how to balance local and national opportunities, it\'s time to organize your scholarship search.', + }, + { + kind: 'paragraph', + text: 'Start by identifying a few scholarships that match your qualifications. Pay attention to their deadlines, award amounts, and application requirements.', + }, + { + kind: 'paragraph', + text: 'Use Aid Tracker to save the opportunities you\'re interested in and keep track of your progress.', + }, + { + kind: 'callout', + title: 'Up Next: Build Your Scholarship Tracker', + text: 'You\'ll create an organized list of scholarships, track important deadlines, and start developing a plan for your applications.', + variant: 'info', + }, ], }, { @@ -650,110 +1268,398 @@ export const CHECKLIST_CONTENT: ChecklistContent[] = [ { kind: 'heading', text: 'Assignment: Create Your Scholarship Tracking System' }, { kind: 'paragraph', - text: 'Applying to scholarships is a lot like applying to colleges — you need a system to stay organized. In this assignment, you\'ll set up a tracker to manage your scholarship search and applications throughout junior and senior year.', + text: 'Finding scholarships is only the beginning. Between different deadlines, eligibility requirements, essays, and application materials, it\'s easy to lose track of opportunities.', + }, + { + kind: 'paragraph', + text: 'That\'s why having a scholarship tracker is so important.', + }, + { + kind: 'paragraph', + text: 'In this assignment, you\'ll start building your own scholarship list in Aid Tracker. By the end, you\'ll have an organized list of opportunities you qualify for and a clear idea of what to do next.', }, { kind: 'callout', - title: 'Good News', - text: 'You can use the Scholarship Tracker built into this module! Head to the My Scholarships tab to start adding scholarships from our database or manually. This assignment walks you through the strategy behind building your list.', + title: 'Good News: Edvifi Makes It Easy!', + text: 'You don\'t need to create a spreadsheet or keep track of everything yourself. Head to the **Aid Tracker** tab to save scholarships from Edvifi\'s database or add opportunities you\'ve found elsewhere.', variant: 'tip', }, - { kind: 'heading', text: 'Step 1: Set Up Your Categories' }, + { kind: 'heading', text: 'Step 1: Find and Save 5 Scholarships' }, { kind: 'paragraph', - text: 'Organize scholarships into groups that help you prioritize your time and effort.', + text: 'Using the strategies you\'ve learned in the previous articles, find at least **5 scholarships you qualify for**.', }, { - kind: 'checklist', - title: 'For each scholarship, track these details', + kind: 'paragraph', + text: 'Try to include a mix of opportunities:', + }, + { + kind: 'list', + items: [ + '**Local scholarships:** Offered by your school, community foundations, local businesses, or other organizations in your area.', + '**Specialized scholarships:** Opportunities matching your background, interests, experiences, or intended major.', + '**National scholarships:** Programs open to students across the country that match your qualifications.', + ], + }, + { + kind: 'paragraph', + text: 'You don\'t need a specific number from each category. Focus on finding scholarships you\'re eligible for and genuinely interested in applying to.', + }, + { + kind: 'callout', + title: 'Edvifi Tip: Start With What You Know', + text: 'Check your school counselor\'s scholarship list, your prospective colleges\' websites, and Edvifi\'s Scholarship Engine tab. Don\'t worry about finding the perfect scholarships right away. You\'ll continue expanding and refining your list as you go.', + variant: 'tip', + }, + { kind: 'heading', text: 'Step 2: Review and Organize Your Scholarships' }, + { + kind: 'paragraph', + text: 'Once you\'ve found five opportunities, make sure each one has the information you\'ll need to plan your applications.', + }, + { + kind: 'paragraph', + text: 'For each scholarship, check that you\'ve recorded:', + }, + { + kind: 'list', + items: [ + '**Scholarship name and organization:** Who is offering the award?', + '**Award amount:** How much money could you receive? Is it renewable?', + '**Application deadline:** When do you need to submit your application?', + '**Eligibility requirements:** Do you meet the GPA, location, grade level, or other requirements?', + '**Application materials:** Do you need essays, transcripts, recommendation letters, or other documents?', + '**Application status:** Are you researching, preparing, or ready to submit?', + '**Notes:** Any questions, essay ideas, or important details to remember.', + ], + }, + { + kind: 'paragraph', + text: 'If you saved a scholarship directly from Edvifi\'s database, some of this information may already be filled in. Review it against the scholarship provider\'s official website to make sure it\'s accurate and up to date.', + }, + { kind: 'heading', text: 'Step 3: Prioritize Your Opportunities' }, + { + kind: 'paragraph', + text: 'Now that you\'ve started your list, it\'s time to decide which scholarships deserve your attention first.', + }, + { + kind: 'paragraph', + text: 'Review your five scholarships and ask yourself:', + }, + { + kind: 'list', ordered: true, items: [ - 'Scholarship name and organization', - 'Award amount (or range)', - 'Deadline (note if it\'s annual/recurring)', - 'Eligibility requirements (GPA, location, demographic, etc.)', - 'Application materials needed (essay, transcript, recommendation letters)', - 'Application status (Researching, Planning, Ready, Submitted, Awarded)', - 'Your notes (essay ideas, contact info, questions)', + '**Which deadlines are coming up soon?** These may need your immediate attention.', + '**Which scholarships are the strongest match for my qualifications?** Consider your eligibility, interests, and experiences.', + '**Which applications will take the most time?** Scholarships requiring essays or recommendation letters may need more preparation.', + '**Which scholarships offer the most value?** Consider both the award amount and whether funding is renewable.', ], }, - { kind: 'heading', text: 'Step 2: Research and Add at Least 15 Scholarships' }, { kind: 'paragraph', - text: 'Using the strategies from the "How to Find Scholarships" article, research and add at least 15 scholarships to your tracker. Aim for a mix:', + text: 'Use your tracker to identify the scholarships you want to prioritize.', + }, + { + kind: 'callout', + title: 'Edvifi Tip: Don\'t Wait Until the Deadline', + text: 'Aim to complete applications several days before they\'re due. This gives you time to review your materials and resolve unexpected problems. For scholarships requiring recommendation letters, try to give your recommenders at least three to four weeks\' notice.', + variant: 'tip', + }, + { kind: 'heading', text: 'Step 4: Keep Your Tracker Updated' }, + { + kind: 'paragraph', + text: 'Your scholarship tracker isn\'t something you complete once and forget about.', + }, + { + kind: 'paragraph', + text: 'As you continue your scholarship search:', }, { kind: 'list', items: [ - '5+ local scholarships (community organizations, local businesses, school counselor list)', - '5+ scholarships matching your unique background or interests', - '5+ national scholarships you meet the eligibility for', + 'Add new scholarships you discover.', + 'Update your application status as you make progress.', + 'Record important deadlines and requirements.', + 'Mark applications as submitted once you\'ve applied.', + 'Record scholarship awards when you receive decisions.', ], }, - { kind: 'heading', text: 'Step 3: Prioritize by Deadline and Fit' }, { kind: 'paragraph', - text: 'Sort your list by deadline so you never miss one. Then, star the scholarships where you feel you\'re the strongest fit — these are where you should invest the most effort in your application essays and materials.', + text: 'Keeping your tracker updated will help you stay organized throughout senior year.', + }, + { kind: 'heading', text: 'Assignment Checklist' }, + { + kind: 'checklist', + title: 'Before marking this assignment complete, make sure you\'ve:', + items: [ + 'Added at least 5 scholarships to Aid Tracker.', + 'Confirmed that you meet the eligibility requirements for each.', + 'Reviewed the deadlines and application materials.', + 'Identified which scholarships you want to prioritize.', + ], }, { kind: 'callout', - title: 'Deliverable', - text: 'Your tracker should have at least 15 scholarships added with deadlines, amounts, and application requirements noted. You\'ll use this list as the foundation for the "Identify 10 Scholarships" task later.', + title: 'Your Deliverable', + text: 'You should now have **at least five scholarships saved in Aid Tracker**, with their deadlines, award amounts, eligibility requirements, and application materials recorded. You\'ll build on this list in the next assignment, where you\'ll identify ten scholarships to target during senior year.', variant: 'info', }, ], }, { - id: 'sr-3', - title: 'Local vs. National Scholarships: Where to Start', + id: 'sr-6', + title: 'How to Apply for Scholarships and Improve Your Chances', type: 'article', body: [ - { kind: 'heading', text: 'The Case for Starting Local' }, + { kind: 'heading', text: 'Finding Scholarships Is Just the Beginning' }, + { + kind: 'paragraph', + text: 'You\'ve learned how to find scholarships, identify opportunities you qualify for, and organize them in Aid Tracker. Now it\'s time to turn those opportunities into actual applications.', + }, + { + kind: 'paragraph', + text: 'Applying for scholarships can feel intimidating, especially when you\'re asked to write essays, request recommendation letters, or explain why you deserve an award.', + }, + { + kind: 'paragraph', + text: 'But here\'s the good news: **You don\'t have to be the most accomplished student to submit a strong scholarship application.**', + }, + { + kind: 'paragraph', + text: 'Scholarship committees are often looking for students who demonstrate qualities like determination, leadership, community involvement, or a commitment to their education. What matters is understanding what each scholarship is looking for and showing how your experiences align with its goals.', + }, + { kind: 'heading', text: 'Understand What the Scholarship Is Looking For' }, + { + kind: 'paragraph', + text: 'Before starting an application, take a few minutes to learn about the organization offering the scholarship.', + }, { kind: 'paragraph', - text: 'When most people think of scholarships, they picture the big national ones — Gates Scholarship, Coca-Cola Scholars, QuestBridge. These are prestigious and valuable, but they\'re also extraordinarily competitive. The Gates Scholarship, for example, receives over 50,000 applications for about 300 awards. Your odds? Roughly 0.6%.', + text: 'Ask yourself:', + }, + { + kind: 'list', + items: [ + '**What is the scholarship\'s purpose?** Is it intended to support students with financial need, recognize academic achievement, or encourage students to pursue a particular career?', + '**What qualities does the organization value?** Leadership, perseverance, community service, creativity, or academic dedication?', + '**What makes me a good fit?** Which of my experiences, accomplishments, or goals connect to the scholarship\'s mission?', + ], }, { kind: 'paragraph', - text: 'Local scholarships tell a very different story. Your town\'s Rotary Club scholarship might get 30 applications for 3 awards. That\'s a 10% chance — roughly 17 times better odds. And here\'s the thing: those $500-$2,000 local scholarships add up. Five local scholarships at $1,000 each equals one $5,000 national scholarship, with a fraction of the effort.', + text: 'For example, if a scholarship focuses on community service, your volunteer experiences may be more relevant than your GPA. If it\'s designed for future healthcare professionals, explaining why you\'re interested in healthcare could strengthen your application.', }, { kind: 'callout', - title: 'Math That Matters', - text: 'Students who apply to 10 local scholarships typically win more total money than students who apply to 10 national scholarships. Volume plus better odds equals better results.', + title: 'Edvifi Tip: Read Beyond the Requirements', + text: 'Eligibility requirements tell you whether you *can* apply. The scholarship\'s mission and selection criteria can help you understand what makes a *strong* applicant.', variant: 'tip', }, - { kind: 'heading', text: 'Where to Find Local Scholarships' }, + { kind: 'heading', text: 'Prepare Your Application Materials' }, + { + kind: 'paragraph', + text: 'Different scholarships require different documents, but many ask for similar materials.', + }, + { + kind: 'paragraph', + text: 'Common requirements include:', + }, + { + kind: 'list', + items: [ + '**Academic transcripts:** A record of your grades and courses, usually available through your high school.', + '**Essays or personal statements:** Written responses about your experiences, goals, accomplishments, or challenges.', + '**Recommendation letters:** Letters from teachers, counselors, employers, or community members who can speak to your character and abilities.', + '**Activity lists or résumés:** Summaries of your extracurricular activities, jobs, volunteer work, and leadership experiences.', + '**Financial information:** Some need-based scholarships request information about your household income or financial circumstances.', + '**Proof of eligibility:** Certain scholarships may request documentation confirming residency, enrollment, or other requirements.', + ], + }, + { + kind: 'paragraph', + text: 'You won\'t need all these materials for every application.', + }, + { + kind: 'callout', + title: 'Edvifi Tip: Create a Scholarship Application Folder', + text: 'Keep copies of your transcript, résumé, essays, and other frequently requested documents in one organized folder. This will save time when you\'re applying to multiple scholarships. Store sensitive financial and identification documents securely, and share them only through verified application channels.', + variant: 'tip', + }, + { kind: 'heading', text: 'Write a Strong Scholarship Essay' }, + { + kind: 'paragraph', + text: 'Many scholarships require an essay, but you don\'t need to be an extraordinary writer to tell a compelling story.', + }, + { + kind: 'paragraph', + text: 'A strong scholarship essay helps the reader understand who you are, what matters to you, and why you\'re a good fit for the award.', + }, + { + kind: 'paragraph', + text: 'Here are some strategies:', + }, + { kind: 'heading', level: 3, text: '1. Answer the Actual Question' }, + { + kind: 'paragraph', + text: 'Read the essay prompt carefully. If the scholarship asks about leadership, focus on an experience that demonstrates leadership rather than writing a general essay about your academic goals.', + }, + { kind: 'heading', level: 3, text: '2. Be Specific' }, + { + kind: 'paragraph', + text: 'Instead of saying, "I\'m passionate about helping others," describe a time you helped someone, what you did, and what you learned.', + }, + { + kind: 'paragraph', + text: 'Specific examples make your essay more personal and memorable.', + }, + { kind: 'heading', level: 3, text: '3. Show Growth and Reflection' }, + { + kind: 'paragraph', + text: 'Scholarship committees often want to understand how your experiences have shaped you.', + }, + { + kind: 'paragraph', + text: 'You can discuss challenges you\'ve overcome, lessons you\'ve learned, or goals you\'re working toward.', + }, + { + kind: 'paragraph', + text: 'You don\'t need to share painful or deeply personal experiences to write a meaningful essay. Choose a story you\'re comfortable telling.', + }, + { kind: 'heading', level: 3, text: '4. Connect Your Story to the Scholarship' }, + { + kind: 'paragraph', + text: 'Explain how your experiences, interests, or goals align with the scholarship\'s purpose.', + }, + { kind: 'heading', level: 3, text: '5. Review and Revise' }, + { + kind: 'paragraph', + text: 'Before submitting, check your essay for clarity, grammar, word limits, and whether you\'ve fully answered the prompt.', + }, + { + kind: 'paragraph', + text: 'If possible, ask a teacher, counselor, or trusted adult to review it.', + }, + { + kind: 'callout', + title: 'Edvifi Tip: Reuse Your Work Strategically', + text: 'Many scholarships ask similar questions about leadership, community involvement, career goals, or personal experiences. You can reuse ideas and adapt essays you\'ve already written, including college application essays. Just make sure every response addresses the specific scholarship prompt.', + variant: 'tip', + }, + { kind: 'heading', text: 'Ask for Recommendation Letters Early' }, + { + kind: 'paragraph', + text: 'Some scholarships require recommendation letters from people who know you well.', + }, + { + kind: 'paragraph', + text: 'Good recommenders might include:', + }, + { + kind: 'list', + items: [ + 'Teachers who know your academic abilities or work ethic.', + 'School counselors familiar with your goals and circumstances.', + 'Employers who can speak to your responsibility and dedication.', + 'Coaches, mentors, or community leaders who have worked closely with you.', + ], + }, + { + kind: 'paragraph', + text: '**Choose someone who knows you well, not simply someone with an impressive title.**', + }, + { + kind: 'paragraph', + text: 'A thoughtful letter from a teacher who has seen your growth may be more valuable than a generic letter from someone who barely knows you.', + }, + { + kind: 'paragraph', + text: 'When requesting a letter:', + }, + { + kind: 'list', ordered: true, + items: [ + 'Ask at least three to four weeks before the deadline whenever possible.', + 'Explain which scholarship you\'re applying for and why.', + 'Share your résumé, accomplishments, or goals to help the recommender write a detailed letter.', + 'Provide clear submission instructions and the deadline.', + 'Thank your recommender for their time.', + ], + }, + { + kind: 'paragraph', + text: 'Remember that teachers and counselors may be writing letters for many students, especially during senior year.', + }, + { kind: 'heading', text: 'Avoid Common Application Mistakes' }, + { + kind: 'paragraph', + text: 'Even strong applicants can miss out on opportunities because of preventable mistakes.', + }, + { + kind: 'paragraph', + text: 'Before submitting, make sure you:', + }, { kind: 'list', items: [ - 'Your high school counseling office — they maintain a running list, often posted on a bulletin board or website', - 'Your local community foundation — search "[your county] community foundation"', - 'Civic organizations in your area — Rotary, Kiwanis, Lions Club, Elks Lodge, VFW', - 'Local businesses — banks, law firms, medical practices, and retailers sometimes sponsor scholarships', - 'Your parents\' employers — many offer scholarships for employees\' children', - 'Religious organizations — churches, mosques, synagogues, and temples', - 'Your school district or PTA', - 'Local newspaper or media companies', + '**Meet the eligibility requirements:** Double-check that you qualify before investing time in the application.', + '**Follow all instructions:** Pay attention to word limits, document formats, and submission requirements.', + '**Submit every required document:** Missing transcripts, essays, or recommendation letters can make an application incomplete.', + '**Personalize your responses:** Avoid submitting the same generic essay to every scholarship.', + '**Proofread carefully:** Review your application for errors, unclear responses, and missing information.', + '**Submit before the deadline:** Don\'t wait until the final minutes, when technical problems could prevent submission.', ], }, - { kind: 'heading', text: 'When National Makes Sense' }, + { + kind: 'callout', + title: 'Edvifi Tip: Set Your Own Deadline', + text: 'If a scholarship application is due on March 15, aim to finish by March 12. Giving yourself a few extra days provides time to review your application, confirm recommendation letters have been submitted, and handle unexpected problems.', + variant: 'tip', + }, + { kind: 'heading', text: 'What Happens After You Apply?' }, + { + kind: 'paragraph', + text: 'Submitting your application is an important milestone, but your work isn\'t necessarily finished.', + }, { kind: 'paragraph', - text: 'National scholarships are absolutely worth applying to — especially if you have a strong profile match. The key is to be strategic about which ones you target.', + text: 'After applying:', }, { kind: 'list', items: [ - 'Apply to national scholarships where your background or story gives you a genuine edge', - 'Focus on scholarships in your specific field of interest (e.g., STEM, arts, public service)', - 'Look for "niche" national scholarships with fewer applicants (e.g., for students interested in a specific career)', - 'Many national scholarship essays can be repurposed for multiple applications — write one strong essay and adapt it', + '**Update Aid Tracker:** Mark the application as submitted and record any confirmation number or email.', + '**Check your email:** Scholarship organizations may contact you for interviews, additional documents, or award notifications.', + '**Follow up when appropriate:** If the organization provides a decision timeline, wait until that period has passed before asking for an update.', + '**Report scholarships to your college:** If you receive an award, contact your college\'s financial aid office to learn how it affects your financial aid package.', + '**Review award conditions:** Check whether you need to maintain a particular GPA, enrollment status, or other requirements to keep the scholarship.', ], }, - { kind: 'heading', text: 'The Ideal Strategy' }, { kind: 'paragraph', - text: 'Build a balanced portfolio: a foundation of local scholarships (high odds, less competition), a selection of niche national scholarships (moderate odds, good fit), and a few "reach" prestigious scholarships (low odds, high reward). Treat it like a college list — you want safeties, targets, and reaches.', + text: 'And remember: **Not winning a scholarship doesn\'t mean your application wasn\'t strong.** Many scholarships are competitive, and selection decisions depend on factors outside your control.', + }, + { + kind: 'paragraph', + text: 'Keep applying to opportunities that match your qualifications.', + }, + { kind: 'heading', text: 'Your Next Step: Create Your Scholarship Application Plan' }, + { + kind: 'paragraph', + text: 'You now know how to prepare your materials, write stronger applications, and avoid common mistakes.', + }, + { + kind: 'paragraph', + text: 'The next step is putting everything together into a realistic plan.', + }, + { + kind: 'paragraph', + text: 'Return to Aid Tracker and review the opportunities you\'ve saved. Think about which scholarships you want to apply for first, what materials you\'ll need, and how much time each application will take.', + }, + { + kind: 'callout', + title: 'Up Next: Identify 10 Scholarships to Apply to Senior Year', + text: 'You\'ll expand your scholarship list, choose your highest-priority opportunities, and create a plan to start submitting applications.', + variant: 'info', }, ], }, @@ -794,7 +1700,7 @@ export const CHECKLIST_CONTENT: ChecklistContent[] = [ { kind: 'list', items: [ - 'Check the Discover tab in this module for scholarships from our database', + 'Check the Scholarship Engine tab in this module for scholarships from our database', 'Visit your school counselor and ask for the current year\'s scholarship binder or list', 'Search Fastweb.com and Scholarships.com with your profile information', 'Ask your parent(s) if their employer offers scholarships for dependents', diff --git a/web/src/index.css b/web/src/index.css index 55ad870..4fbc4c6 100644 --- a/web/src/index.css +++ b/web/src/index.css @@ -979,11 +979,11 @@ button { gap: 14px; align-items: center; } -/* My Scholarships: the cue to add a date where a scholarship has none. */ +/* Aid Tracker: the cue to add a date where a scholarship has none. */ .add-date-cue { transition: background 0.15s ease, border-color 0.15s ease; } .add-date-cue:hover { border-style: solid !important; background: color-mix(in srgb, currentColor 14%, transparent) !important; } .add-date-cue:focus-within { outline: 2px solid currentColor; outline-offset: 2px; } -/* Rows with no logo column (My Scholarships). */ +/* Rows with no logo column (Aid Tracker). */ .ast-grid.no-logo { grid-template-columns: 44px minmax(0, 1fr) 130px 118px 12px; } .ast-row { transition: background 0.15s ease; } .ast-row:hover { background: var(--surface-hover) !important; } diff --git a/web/src/lib/aidPrefs.ts b/web/src/lib/aidPrefs.ts index 5d0880b..5e7fcff 100644 --- a/web/src/lib/aidPrefs.ts +++ b/web/src/lib/aidPrefs.ts @@ -1,5 +1,5 @@ /** - * Aid Engine preferences, asked once before the first matches (like Discover's + * Scholarship Engine preferences, asked once before the first matches (like Discover's * college preferences) and persisted to settings.module_data.fafsa.aidPrefs. * * Interests add to the profile's tags, so they raise the score of awards for diff --git a/web/src/lib/fafsaData.ts b/web/src/lib/fafsaData.ts index 8751ef0..aaa09a4 100644 --- a/web/src/lib/fafsaData.ts +++ b/web/src/lib/fafsaData.ts @@ -514,7 +514,7 @@ export function scoreScholarshipForProfile( ruledOut = true } // Ruled out, as when both caps are missed: a single mother's award was the - // Aid Engine's "Closes soon" pick for a 17-year-old. + // Scholarship Engine's "Closes soon" pick for a 17-year-old. const grades = userProfile?.grade != null ? highSchoolGrades(scholarship.eligibility_summary) : null if (scholarship.demographic_tags.some((t) => PAST_HIGH_SCHOOL_TAGS.includes(t) && !userTagSet.has(t)) || (grades && !grades.has(userProfile!.grade!))) {