A comprehensive business calculator portal with premium features, GitHub authentication, and modern user experience. Built with Next.js, TypeScript, and Tailwind CSS.
Calculator Startsim.AI is now live with 11 professional calculators, premium access control, and a beautiful modern interface.
- 11 Professional Calculators across multiple categories
- 7 Premium Calculators with GitHub authentication
- 4 Public Calculators accessible to everyone
- Smart Search & Filtering with real-time results
- GitHub OAuth Integration for secure access
- Premium Access Control for exclusive calculators
- Enhanced Logout System with confirmation modals
- Visual Login Indicators and welcome messages
- Beautiful Gradient Design with smooth animations
- Responsive Layout optimized for all devices
- Loading States and progress indicators
- Toast Notifications for user feedback
- Social Media Sharing integration
- Open Graph Tags for rich social media previews
- Structured Data with Schema.org markup
- Dynamic Metadata for each calculator
- PWA Support with offline capabilities
- Optimized Performance with Next.js 15
- Selling Price Calculator - Optimize your pricing strategies
- Free Conversion & Pricing Calculator - Unit conversion and pricing tools
- $1 Simulation Game - Interactive financial simulation
- Simple Text to Image Generator - Basic image generation tool
- Life Calculator - Life expectancy and planning tools
- Unit Value Comparison Tool - Advanced comparison analytics
- Churn Rate Threshold Calculator - Business retention metrics
- Peace of Mind & Emergency Fund Calculator - Financial security planning
- Budget Calculator - Advanced budgeting with scenarios
- YouTube AI Summarizer - AI-powered video content analysis
- ΰΉΰΈΰΈ£ΰΈ·ΰΉΰΈΰΈΰΈΰΈ³ΰΈΰΈ§ΰΈΰΉΰΈΰΈ΄ΰΈΰΈΰΈΰΈ‘ΰΉΰΈΰΈ©ΰΈ΅ΰΈ’ΰΈ - Thai retirement savings calculator
- Next.js 15.4.5 with App Router and Turbopack
- TypeScript for full type safety
- Tailwind CSS with custom design system
- Lucide React for consistent iconography
- React Hooks for modern state management
- Turso SQLite cloud-native database
- Drizzle ORM with type-safe operations
- NextAuth.js 4.24.11 for GitHub authentication
- API Routes for RESTful endpoints
- Vercel for serverless deployment
- GitHub for version control and CI/CD
- Environment Variables for secure configuration
- ESLint for code quality
- Node.js 18+
- npm or yarn
- GitHub account (for authentication)
- Turso account (for database)
- Clone the repository
git clone https://github.com/dominixz/calculator-startsim-ai.git
cd calculator-startsim-ai- Install dependencies
npm install- Set up environment variables
cp .env.local.example .env.localEdit .env.local with your configurations:
# Database
TURSO_DATABASE_URL=your_turso_database_url
TURSO_AUTH_TOKEN=your_turso_auth_token
# NextAuth.js
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_nextauth_secret
# GitHub OAuth
GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_client_secret- Set up database
npm run db:push- Run development server
npm run devVisit http://localhost:3000 to see your application.
Edit .env.local and add your Turso database credentials:
TURSO_DATABASE_URL: Your Turso database URLTURSO_AUTH_TOKEN: Your Turso authentication token
- Set up the database
npm run db:generate
npm run db:migrate- Run the development server
npm run devOpen http://localhost:3000 to see the application.
- Sign up at turso.tech
- Create a new database
- Get your database URL and auth token
- Add them to your
.env.localfile
npm run db:generate- Generate migration filesnpm run db:migrate- Run migrationsnpm run db:studio- Open Drizzle Studio (database GUI)
- Push your code to GitHub
git add .
git commit -m "Initial commit"
git push origin main-
Connect to Vercel
- Go to vercel.com
- Import your GitHub repository
- Vercel will auto-detect Next.js settings
-
Add Environment Variables in Vercel Dashboard
TURSO_DATABASE_URL:libsql://freestartsimai-dominixz.aws-ap-northeast-1.turso.ioTURSO_AUTH_TOKEN: Your Turso auth tokenNEXTAUTH_URL: Your production URL (e.g.,https://your-app.vercel.app)NEXTAUTH_SECRET: Generate a secure secret key
-
Deploy!
- Vercel will automatically deploy on every push
- Your app will be available at
https://your-app.vercel.app
- Database is already set up and configured for SSR
- Environment variables are properly configured
- The app uses server-side rendering for better performance
- All API routes work with Vercel's serverless functions
The app is optimized for Vercel deployment with proper environment variable handling and SSR support.
- Create a new component in
src/components/calculators/ - Add the calculator to the routes in
src/app/calculators/[slug]/page.tsx - Update the calculator list in
src/app/page.tsxandsrc/app/calculators/page.tsx
src/
βββ app/ # Next.js App Router pages
βββ components/ # Reusable components
β βββ calculators/ # Calculator components
β βββ layout/ # Layout components
β βββ ui/ # UI components
βββ lib/ # Utilities and database
βββ types/ # TypeScript type definitions
Required environment variables:
TURSO_DATABASE_URL- Your Turso database URLTURSO_AUTH_TOKEN- Your Turso authentication tokenNEXTAUTH_URL- Your app URL (for production)NEXTAUTH_SECRET- NextAuth.js secret (for authentication)GITHUB_CLIENT_ID- GitHub OAuth client IDGITHUB_CLIENT_SECRET- GitHub OAuth client secret
- Fork/Clone the repository
- Set up environment variables (see
.env.example) - Deploy to Vercel or your preferred platform
- Configure GitHub OAuth with your production URLs
For detailed deployment instructions, see DEPLOYMENT.md.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if needed
- Submit a pull request
This project is licensed under the MIT License.
If you need help setting up the project or have questions, please create an issue in the repository.