The world's most comprehensive geographical database providing accurate country, state, and city data to developers worldwide. This repository contains the official website and marketing platform for CSC Database.
CSC Database is a comprehensive geographical database that provides:
- Global Coverage: Complete data for countries, states, and cities worldwide
- Multiple Access Methods: REST API, GraphQL API, and direct database downloads
- Various Formats: JSON, CSV, SQL, XML, YAML, MongoDB exports
- Open Source: MIT licensed for unlimited commercial use
- Developer Friendly: Sub-200ms response times with 99.9% uptime SLA
- Community Driven: Crowdsourced updates and contributions
- Fast REST and GraphQL endpoints
- Real-time geographical data queries
- Sub-200ms response times
- Comprehensive country, state, and city coverage
- Open-source geographical database
- 9+ export formats available
- MIT licensed for commercial use
- Regular updates and community contributions
- Download curated datasets
- Multiple format options (CSV, JSON, SQL)
- Free and premium tiers available
- Custom data filtering options
- Submit data feedback and corrections
- Report issues with existing data
- Suggest new geographical entries
- Community-driven data improvement
- Framework: Next.js 16 with App Router and static export
- Styling: Tailwind CSS 4
- UI Components: Custom components with Radix UI primitives
- Animations: CSS animations with reduced-motion support
- Icons: Local SVGs in
src/icons/; Lucide for the configured shadcn registry and documented examples - Development: ESLint, Turbopack for fast development
- Node.js 26 recommended (also supports 20.19+, 22.13+, and 24+; CI checks Node 22 and 26)
- npm (use
npm cito install the committed lockfile)
- Clone the repository:
git clone https://github.com/dr5hn/csc-website.git
cd csc-website- Install dependencies:
npm ci- Run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev- Open http://localhost:3000 in your browser to see the website.
npm run dev- Start development server with Turbopacknpm run build- Build the application for productionnpm run start- Start the production servernpm run lint- Run ESLint for code quality checks
src/
├── app/ # Next.js App Router pages
│ ├── about/ # About page
│ ├── contact/ # Contact page
│ ├── faqs/ # FAQ page
│ ├── pricing/ # Pricing page
│ └── product/ # Product pages (API, Database, Export Tool, Update Tool)
├── components/ # React components
│ ├── ui/ # Reusable UI components
│ ├── product/ # Product-specific components
│ └── animate-ui/ # Animation components
├── data/ # Static data and configurations
├── hooks/ # Custom React hooks
├── icons/ # Custom icon components
└── lib/ # Utility functions and configurations
- Hero Section: Interactive 3D globe with geographical data visualization
- Product Cards: Feature showcases for API, Database, Export, and Update tools
- Pricing Components: Flexible pricing tables for different service tiers
- Contact Forms: User interaction and feedback collection
- Stats Display: Real-time statistics and social proof
- Testimonials: Animated customer testimonials
The easiest way to deploy this Next.js application:
- Push your code to GitHub
- Connect your repository to Vercel
- Deploy automatically with every push
This application can be deployed on any platform that supports Node.js:
- Netlify: Use the build command
npm run build - AWS Amplify: Configure with Next.js build settings
- DigitalOcean App Platform: Deploy with default Next.js configuration
- Railway: One-click deployment with GitHub integration
We welcome contributions to improve the CSC Database website! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes: Follow our coding standards and conventions
- Test thoroughly: Ensure your changes don't break existing functionality
- Commit your changes:
git commit -m 'Add some amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request: Describe your changes and their benefits
- Follow the existing code style and component patterns
- Use TypeScript where applicable
- Ensure responsive design across all screen sizes
- Test your changes across different browsers
- Update documentation if needed
This project is licensed under the MIT License - see the LICENSE file for details.
- Website: Visit CSC Database
- Documentation: API Documentation
- Issues: GitHub Issues
- Community: Join our developer community for updates and support
- Thanks to all contributors who help maintain and improve geographical data
- Built with ❤️ by developers, for developers
- Trusted by thousands of developers worldwide
Made with ❤️ for the global developer community