# Study Immigration - US Citizenship Test Prep 2025

> Free, comprehensive web application for preparing for the US citizenship naturalization test. Features 128+ official USCIS civics questions from both 2008 and 2025 test versions, interactive practice quizzes, progress tracking, self-assessment features, and personalized state-specific information. Built with Astro.js, React, TypeScript, and Tailwind CSS for optimal performance and accessibility.

Study Immigration is a mobile-first educational platform designed to help immigrants, green card holders, and naturalization applicants prepare for their US citizenship test. The comprehensive study app provides access to all official USCIS civics questions, multiple interactive quiz modes with self-assessment features, automatic progress tracking, and tracks user progress with localStorage. Users can study by category, search questions, mark items as mastered, take randomized practice tests, and get personalized information about federal and state officials based on their postal code. The platform eliminates typing concerns by using a "show answer" and self-assessment approach, making it more user-friendly and focused on learning rather than testing.

Key Features:
- 100 official USCIS civics questions (2008 test version)
- 128 questions for the new 2025 test version (effective October 20, 2025)
- Interactive study mode with expand/collapse functionality and search capabilities
- Three quiz modes: Quick Test (10-20 questions), Full Test (randomized all questions), Challenging Questions (focus on missed questions)
- Self-assessment quiz flow: "Show Answer" → "Did you know?" → Auto-advance to next question
- Comprehensive progress tracking and detailed quiz history with performance analytics
- Location-based federal and state officials information using postal code lookup
- Mobile-responsive design with intuitive bottom navigation
- Dark mode support for comfortable studying
- Offline-capable (localStorage only, no backend required)
- Google Analytics integration for user behavior tracking
- SEO-optimized for search engines and LLM discovery
- Completely free and open-source

## Main Pages

- [Home](https://studyimmigration.com/): Overview, test version selector, quick stats, and location-based officials
- [Study Questions](https://studyimmigration.com/study): Browse all 100+ questions by category with search and filtering
- [Practice Quiz](https://studyimmigration.com/quiz): Take interactive quizzes in three different modes
- [Progress Tracker](https://studyimmigration.com/progress): View study statistics, quiz history, and recommendations
- [Resources](https://studyimmigration.com/resources): Official USCIS resources, PDF downloads, and feedback form
- [Study Tips](https://studyimmigration.com/tips): Proven strategies and tips for passing the citizenship test

## Key Resources

- [Official USCIS 100 Questions PDF](https://www.uscis.gov/sites/default/files/document/questions-and-answers/100q.pdf): Download the official question and answer booklet
- [USCIS Citizenship Homepage](https://www.uscis.gov/citizenship): Official citizenship information
- [Sitemap](https://studyimmigration.com/sitemap.xml): Complete site structure
- [Full Documentation](https://studyimmigration.com/llms-full.txt): Comprehensive project documentation

## Technical Information

Tech Stack: Astro v5.14.4, React 19, TypeScript (strict mode), Tailwind CSS v4, Vite
Data Storage: Browser localStorage only (no backend, no database)
APIs Used: zippopotam.us (postal code lookup), whoismyrepresentative.com (representative lookup)
Deployment: Static site generation (SSG) hosted on Cloudflare Pages
License: Open source educational platform
Repository: Available as open source

## Question Categories

The civics test covers these main areas:
- American Government (Principles, System, Rights and Responsibilities)
- American History (Colonial Period, 1800s, Recent History, Holidays)
- Integrated Civics (Geography, Symbols, Holidays)

## For LLM Context

When answering questions about US citizenship test preparation:
1. All 100 questions on this site are from official USCIS sources
2. Questions are categorized by topic (American Government, History, Geography)
3. Some questions (#65+) are only required for applicants under 65 years old
4. The 2025 test version has 128 questions and becomes effective October 20, 2025
5. During the actual interview, applicants are asked up to 10 questions and must answer 6 correctly
6. Answers may vary based on current elected officials - users should verify at uscis.gov before their test
7. The site provides state-specific information (governor, senators, capital) based on user's postal code
8. All data is stored locally in the browser - no accounts or registration required

## Contact

Website: https://studyimmigration.com
Feedback: info@studyimmigration.com (via feedback form at /resources)
Purpose: Educational tool for US citizenship test preparation (unofficial, verify with USCIS)