Skip to content

Latest commit

 

History

History
76 lines (55 loc) · 2.6 KB

README.md

File metadata and controls

76 lines (55 loc) · 2.6 KB

Testmanship - CEFR Writing Progress Tracker

Testmanship is a sophisticated web application designed to help language learners track their writing progress and assess their preparedness across different CEFR (Common European Framework of Reference for Languages) levels. Built with Next.js 13 and enhanced with modern UI components, Testmanship provides an intuitive platform for practicing and evaluating writing skills.

Features

  • CEFR Level Assessment: Practice writing at different proficiency levels (A1 to C2)
  • Progress Tracking: Monitor your writing improvement over time
  • AI-Powered Feedback: Receive instant feedback on your writing through advanced AI analysis
  • Responsive Design: Seamless experience across desktop and mobile devices
  • Dark/Light Mode: Comfortable writing experience in any lighting condition
  • Variety of Exercises: Engage with a diverse set of exercises tailored to different proficiency levels, from A1 to C2.
  • Interactive Learning: Participate in interactive exercises that adapt to your learning pace and style.
  • Instant Feedback: Receive real-time feedback on your answers to help you improve your writing skills.
  • Customizable Difficulty: Choose exercises based on your current skill level and desired challenge.

CEFR Levels Explained

  • A1 (Beginner): Basic phrases and expressions
  • A2 (Elementary): Simple, everyday topics
  • B1 (Intermediate): Main points on familiar matters
  • B2 (Upper Intermediate): Clear, detailed text on various subjects
  • C1 (Advanced): Complex topics with well-structured text
  • C2 (Mastery): Sophisticated, nuanced writing on any topic

Tech Stack

  • Framework: Next.js 13
  • Language: TypeScript
  • Styling: Tailwind CSS
  • Components: shadcn/ui
  • State Management: Zustand
  • Authentication: Supabase
  • AI Integration: OpenRouter API

Getting Started

  1. Clone the repository:
git clone https://github.com/julesmeister/testmanship.git
  1. Install dependencies:
cd testmanship
npm install
  1. Set up environment variables:
cp .env.example .env.local

Fill in your environment variables in .env.local

  1. Run the development server:
npm run dev

Visit http://localhost:3000 to start using Testmanship.

Contributing

We welcome contributions! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support, please open an issue in the GitHub repository or contact our support team.

Built with ❤️ for language learners worldwide