A comprehensive, interactive web application designed to help ACSA (Association of California School Administrators) members prepare for education leadership roles including Principal, Vice-Principal, and Superintendent positions.
Try it now: https://alexandria-s-design.github.io/acsa-prep-tool/
Note: The GitHub Pages deployment includes all static features (Resume Builder with templates, Resources page, beautiful UI/UX). AI-powered features (chatbot, interview feedback, AI suggestions) require backend deployment to Vercel with OpenAI API integration. See Deployment Options below.
- Pre-filled Templates: Choose from Principal, Vice-Principal, or Superintendent templates
- Live Preview: See changes in real-time with professional formatting
- Drag & Drop: Reorder sections with SortableJS
- PDF Export: Download beautiful, formatted PDFs with jsPDF
- Auto-save: Progress saved to localStorage every 30 seconds
- AI-Powered Suggestions (requires Vercel deployment for full functionality)
- 18+ curated resources across 5 categories:
- Credentials & Licensing
- Professional Organizations
- Leadership Development
- Interview Preparation
- Books & Publications
- Search and filter functionality
- Interactive cards with hover effects
- Direct links to official sources
- Role & Level Selection
- AI Question Generation (7 tailored questions)
- Voice Input with speech recognition
- AI Feedback & Scoring
- Progress Tracking
- Summary Report with downloadable results
- Dedicated chat interface for in-depth career guidance
- Quick question buttons for common topics
- Voice input option
- Conversation history with context awareness
Simply visit: https://alexandria-s-design.github.io/acsa-prep-tool/
Available Features:
- ✅ Resume Builder with templates
- ✅ PDF Export
- ✅ Resources page
- ✅ Beautiful UI/UX
- ❌ AI features (requires Vercel deployment)
# Clone the repository
git clone https://github.com/Alexandria-s-Design/acsa-prep-tool.git
cd acsa-prep-tool
# Start a local web server (choose one):
# Python 3
python -m http.server 8000
# OR Node.js
npx http-server -p 8000
# Open browser to http://localhost:8000For complete functionality including AI-powered chatbot, interview feedback, and resume suggestions:
-
Fork this repository on GitHub
-
Sign up for Vercel: https://vercel.com/signup
- Click "Continue with GitHub"
-
Import your fork in Vercel dashboard
- Click "Add New" → "Project"
- Select your forked
acsa-prep-toolrepo - Click "Deploy"
-
Add OpenAI API Key (Critical!)
- Get API key from OpenAI Platform
- In Vercel project settings → Environment Variables
- Add:
OPENAI_API_KEY=your-key-here - Check all environments (Production, Preview, Development)
- Click "Redeploy"
-
Share your live URL:
https://your-project.vercel.app
acsa-prep-tool/
├── index.html # Home page with embedded chatbot
├── resume.html # Resume builder
├── interview.html # Interview practice module
├── career-chat.html # Career advisor chatbot
├── resources.html # Resources page
├── api/
│ └── chat.js # Vercel serverless function for OpenAI API
├── js/
│ ├── utils.js # Shared utilities
│ ├── home-chat.js # Home page chatbot logic
│ ├── resume.js # Resume builder logic
│ ├── interview.js # Interview practice logic
│ ├── career-chat.js # Career chat logic
│ └── resources.js # Resources page logic
└── vercel.json # Vercel deployment config
- HTML5 + Vanilla JavaScript
- Tailwind CSS (via CDN)
- SortableJS - Drag-and-drop functionality
- jsPDF - PDF generation
- OpenAI API - GPT-5 for AI features (Vercel deployment)
- Web Speech API - Voice recognition
| Platform | AI Features | Cost | Setup Time | Best For |
|---|---|---|---|---|
| GitHub Pages (current) | ❌ No | Free | 0 min | Static demo, portfolio |
| Vercel (recommended) | ✅ Yes | Free tier + API costs | 5 min | Full features, production |
| Local Server | ✅ Yes* | API costs only | 2 min | Development, testing |
*Requires local .env file with OpenAI API key
API Cost Estimate (with Vercel or local):
- Typical conversation: $0.01-0.05
- Resume suggestions: $0.02-0.03
- Interview practice (7 questions): $0.10-0.20
- Monthly estimate (moderate use): $2-5
- Select a template (Principal, Vice-Principal, or Superintendent)
- Fill in your details (auto-saves every 30s)
- Use AI Suggestions (Vercel deployment only)
- Drag to reorder sections
- Preview in real-time
- Download PDF when ready
- Browse curated resources by category
- Search for keywords
- Filter by category
- Click cards to visit official sources
This is expected! GitHub Pages only supports static hosting. For AI features:
- Deploy to Vercel (see Option 3 above)
- Or run locally with
.envfile containing your OpenAI API key
- Check browser console for jsPDF errors (F12 → Console)
- Verify jsPDF loaded in Network tab
- Try a different browser
- Ensure resume has content before exporting
- Disable private/incognito mode (localStorage required)
- Check console:
localStorage.getItem('resume_data') - Clear data:
localStorage.clear()and restart - Check browser storage settings
| Feature | Chrome | Firefox | Edge | Safari |
|---|---|---|---|---|
| Core App | ✅ | ✅ | ✅ | ✅ |
| Voice Input | ✅ | ✅ | ||
| PDF Export | ✅ | ✅ | ✅ | ✅ |
✅ Full support |
Recommendation: Use Chrome for best experience.
- Resume data stored only in your browser (localStorage)
- No account required
- No tracking or analytics
- API key stored securely in environment variables (Vercel) or
.envfile (local) - Open source - all code is auditable
Designed for:
- ACSA members preparing for leadership interviews
- Aspiring principals and administrators
- Current educators exploring leadership roles
- Education leadership credential programs
Note: Practice tool only. Verify requirements with official sources.
Created for educational purposes for ACSA members.
- ACSA - Association of California School Administrators
- OpenAI - GPT-5 AI model
- Tailwind CSS - Styling framework
- Font Awesome - Icons
- SortableJS - Drag-and-drop
- jsPDF - PDF generation
Built with care for Education Leaders by Alexandria's Design
Version 2.0.0 - January 2025