esa-web-deisgn

byENESI RUTH IZE

I want to redesign the registration/onboarding experience for my existing app: ESA — Excellent Students Academy IMPORTANT: Work with the EXISTING ESA app. Do not rebuild the website or change unrelated pages. Before making changes, inspect the existing login/signup implementation, authentication configuration, User entity, existing student/profile entities, dashboard route, branding, colors, typography, and components. ================================================== MAIN GOAL I want the signup experience to feel like a STUDENT REGISTRATION FORM, not a generic email/password form. The visible onboarding form should focus on collecting student information. However, DO NOT create an insecure custom authentication system. Keep Base44’s secure authentication underneath. Base44 currently requires email/password for its built-in registration, so if those credentials must still exist, keep them handled securely by the authentication system rather than storing passwords in my student profile. If email/password cannot be completely removed from Base44 authentication, do NOT fake or bypass authentication. Instead, make the student-information onboarding the main visual experience and keep the required authentication step as simple as possible. ================================================== ESA SIGN-UP PAGE DESIGN Create a polished registration page that matches the existing ESA branding. Header: ESA logo “Create Your Student Account” Supporting text: “Join Excellent Students Academy and start your learning journey.” The page should look professional, educational, modern and trustworthy. Do not make it childish. ================================================== STUDENT INFORMATION Collect: Full Name Username Country State / Region Class / Level School Name Student Type Date of Birth — optional Profile Photo — optional Required fields should be clearly marked. ================================================== CLASS / LEVEL Use a dropdown. Options: JSS 1 JSS 2 JSS 3 SS 1 SS 2 SS 3 College / University Nursing Student Other Make this easy to edit later. ================================================== STUDENT TYPE Dropdown: Secondary School Student College Student University Student Nursing Student Other ================================================== USERNAME Username must be unique. Check availability before submission. Display: ✓ Username available or: ✕ Username already taken Do not allow duplicate usernames. ================================================== COUNTRY AND STATE Country should use a searchable dropdown. State/Region should update appropriately based on the selected country where possible. Make sure Nigeria includes all Nigerian states and FCT. ================================================== PROFILE PHOTO Add an optional circular profile-photo upload. Text: “Upload Profile Photo” Allow: Select photo Preview photo Change photo Remove photo Make it work properly on mobile/iPhone. ================================================== CAPTCHA Add REAL Cloudflare Turnstile CAPTCHA verification near the bottom of the registration form. The CAPTCHA must actually be validated before registration/profile creation. Do not create a fake CAPTCHA. If the Turnstile credentials/configuration are not currently available in the ESA project, tell me what I need to configure instead of pretending the CAPTCHA is active. ================================================== AUTHENTICATION Inspect the current ESA authentication configuration first. Do not create a custom password system. Do not store passwords in StudentProfile. Do not bypass Base44 authentication. If Base44 requires email/password for account creation, preserve that authentication securely. Where possible, keep the email/password authentication portion visually separate from the student profile onboarding so the main experience feels like: Create Account ↓ Student Information ↓ CAPTCHA ↓ Account Creation ↓ ESA Dashboard Existing users must still be able to log in normally. ================================================== DATABASE Inspect the existing entities before creating anything. If ESA already has a student/profile entity, REUSE IT. If there isn’t one, create: StudentProfile Connect it securely to the authenticated Base44 user. Store: user ID full name username country state/region class/level school name student type date of birth if collected profile photo onboarding completion status created date Do not duplicate student profiles. ================================================== SUCCESS After successful registration: Display: “Welcome to ESA! 🎉” “Your student profile has been created successfully.” Then redirect automatically to the EXISTING ESA student dashboard. Make sure the dashboard displays the student’s correct profile information. ================================================== MOBILE DESIGN Optimize specifically for phones and iPhones. Requirements: One-column layout on mobile. Large touch-friendly fields. No horizontal scrolling. Comfortable spacing. Mobile-friendly dropdowns. Mobile-friendly photo upload. CAPTCHA must fit correctly. Registration button must be easy to tap. ================================================== VALIDATION Show friendly validation messages. Examples: “Please enter your full name.” “Please choose a username.” “That username is already taken.” “Please select your country.” “Please select your class.” “Please enter your school name.” “Please complete the CAPTCHA.” Do not expose technical/backend errors. ================================================== DO NOT BREAK EXISTING ESA Do NOT: Delete existing users. Delete existing student records. Delete the dashboard. Change existing course content. Change the homepage. Break the current login system. Create a second authentication system. Store passwords manually. Create fake CAPTCHA. Create duplicate database entities unnecessarily. Inspect first, then modify only what is necessary. Finally, test the complete flow: Registration → Student Information → Username Validation → CAPTCHA → Secure Authentication → StudentProfile Creation → ESA Dashboard Fix any errors before finishing. And fix the ai tool also so it works properly - https://preview--woodoo-prime-study-path.base44.app/login

No preview

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 8

System Requirements Document for esa-web-deisgn

1. Introduction

The ESA — Excellent Students Academy — aims to redesign its registration/onboarding experience to provide a student-focused registration form while maintaining secure authentication through Base44. The goal is to create a professional, educational, and trustworthy registration experience that aligns with existing ESA branding and infrastructure.

2. System Overview

The redesigned registration experience will focus on collecting student information in a structured and user-friendly manner. The system will maintain Base44's secure email/password authentication while visually emphasizing the student registration form. The redesign will not alter existing ESA systems, such as the dashboard or user records, and will ensure compatibility with mobile devices.

2a. Product Interpretation and Delivery Boundary

The project will deliver a redesigned registration page within the existing ESA app, focusing on student information collection. The Base44 authentication system will remain intact, and no new authentication systems will be created. The redesign will not affect unrelated pages or existing ESA functionalities.

2b. Source Content Inventory

Not applicable as no explicit content_source directive was provided.

Page 2 of 8

2c. Page Content and Component Coverage

Page 3 of 8

ESA Sign-Up Page

  • Header

    • ESA logo
    • "Create Your Student Account" headline
    • Supporting text: "Join Excellent Students Academy and start your learning journey."
  • Student Information Form

    • Full Name (required)
    • Username (required, unique, availability check)
    • Country (searchable dropdown)
    • State/Region (updates based on country)
    • Class/Level (dropdown with options: JSS 1, JSS 2, JSS 3, SS 1, SS 2, SS 3, College/University, Nursing Student, Other)
    • School Name (required)
    • Student Type (dropdown with options: Secondary School Student, College Student, University Student, Nursing Student, Other)
    • Date of Birth (optional)
    • Profile Photo (optional, circular upload with select, preview, change, remove options)
  • CAPTCHA

    • Cloudflare Turnstile CAPTCHA verification
  • Authentication

    • Base44 email/password authentication (visually separate from student information)
  • Success Message

    • "Welcome to ESA! 🎉"
    • "Your student profile has been created successfully."
  • Redirection

    • Automatic redirection to the existing ESA student dashboard
  • Mobile Optimization

    • One-column layout
    • Large touch-friendly fields
    • No horizontal scrolling
    • Comfortable spacing
    • Mobile-friendly dropdowns and photo upload
    • CAPTCHA fitting correctly
    • Easy-to-tap registration button
  • Validation Messages

    • Friendly messages for missing or incorrect information
    • Examples: "Please enter your full name.", "Please choose a username.", "That username is already taken."
Page 4 of 8

3. Functional Requirements

  • As a student, I should be able to register with a unique username, ensuring no duplicates exist. (explicit)
  • As a student, I should be able to upload a profile photo, preview it, and change or remove it if needed. (explicit)
  • As a student, I should be able to select my class/level and student type from dropdowns. (explicit)
  • As a student, I should be able to complete a CAPTCHA verification to ensure secure registration. (explicit)
  • As a student, I should receive a success message and be redirected to the ESA dashboard upon successful registration. (explicit)
  • As a student, I should see friendly validation messages for any missing or incorrect information. (explicit)
  • As an existing user, I should be able to log in normally without changes to the current system. (explicit)

4. User Personas

  • Student
    • Responsibilities: Registering for an account, providing personal and educational information, completing CAPTCHA, and accessing the ESA dashboard.
    • Outcomes: Successful registration, access to the ESA dashboard, and a complete student profile.
Page 5 of 8

5. Core User Flows

  1. Student Registration Flow

    • Student accesses the ESA sign-up page.
    • Student enters full name, username, and other required information.
    • Student selects country and state/region.
    • Student chooses class/level and student type from dropdowns.
    • Student optionally uploads a profile photo.
    • Student completes the CAPTCHA verification.
    • Student submits the form.
    • System checks username availability and validates CAPTCHA.
    • Upon successful validation, the system creates the student profile.
    • Student receives a success message and is redirected to the ESA dashboard.
  2. Existing User Login Flow

    • Existing user accesses the login page.
    • User enters email and password.
    • System authenticates using Base44.
    • User is granted access to the ESA dashboard.
Page 6 of 8

6. Visuals Colors and Theme

  • Muse: Erik Spiekermann
  • Palette:
    • Background: #F6F3EE
    • Surface: #FFFFFF
    • Text: #141517
    • Primary: #E63946
    • Accent: #F1A208
    • Muted: #B1A7A6
  • Typography:
    • Headings: Fira Sans — Bold
    • Body: Source Sans
    • Scale: 1.25 modular
  • Shape Language: Rounded corners for input fields
  • Layout: Single-column for mobile
  • Motion: Functional, restrained tempo
  • Imagery: Minimal, clean icons

7. Signature Design Concept

The ESA sign-up page will feature a centered hero with the ESA logo and headline, supported by the registration form below. The design will use warm neutrals and a clear primary button to guide users through the registration process. Rounded input fields with a soft drop-shadow will enhance the welcoming and approachable interface.

Page 7 of 8

8. Interaction Model & Motion Direction

  • Interaction Model: Static
  • Motion Tempo: Restrained
  • Hero Dimensionality: Flat
  • Landing Hero Motion Brief: The ESA logo and headline will be the focal point, with the registration form appearing below. The motion will be minimal, guiding users through the form with clear transitions between sections.

9. Non-Functional Requirements

  • The system must maintain Base44's secure authentication without creating a custom password system. (explicit)
  • The registration page must be optimized for mobile devices, ensuring usability on phones and iPhones. (explicit)
  • The CAPTCHA must be a real, validated Cloudflare Turnstile CAPTCHA. (explicit)

10. Tech Stack

  • React for front-end development
  • Base44 for authentication
  • Cloudflare Turnstile for CAPTCHA
  • Existing ESA infrastructure for database and user management

11. Assumptions and Constraints

  • The existing ESA app infrastructure will remain unchanged except for the registration page.
  • Base44 authentication will continue to require email/password.
  • The system will not create duplicate student profiles or authentication systems.
Page 8 of 8

12. Glossary

  • ESA: Excellent Students Academy
  • Base44: The authentication system used by ESA
  • CAPTCHA: A challenge-response test to determine whether the user is human
  • Student Profile: The collection of student information stored in the ESA system

No completed page designs yet.

Completed design pages will appear here when they are ready to preview.

ESA Sign-Up Page: View sign-up page
ESA Sign-Up Page: Enter student information
ESA Sign-Up Page: Select country and state
ESA Sign-Up Page: Choose class and type
ESA Sign-Up Page: Upload profile photo
ESA Sign-Up Page: Complete CAPTCHA verification
ESA Sign-Up Page: Submit registration form
ESA Dashboard: View success redirect
Login page: Enter email password
ESA Dashboard: View student dashboard

No completed page designs yet.

Completed design pages will appear here when they are ready to preview.

ESA Sign-Up Page: View sign-up page
ESA Sign-Up Page: Enter student information
ESA Sign-Up Page: Select country and state
ESA Sign-Up Page: Choose class and type
ESA Sign-Up Page: Upload profile photo
ESA Sign-Up Page: Complete CAPTCHA verification
ESA Sign-Up Page: Submit registration form
ESA Dashboard: View success redirect
Login page: Enter email password
ESA Dashboard: View student dashboard