Live Prototype β’ Documentation β’ Contributing β’ Governance β’ Contact
Tech Atlas is an open-source platform designed to solve a fundamental problem in Uganda's tech ecosystem: fragmentation. Information about hubs, communities, startups, jobs, and opportunities is scattered across countless platforms and personal networks.
Tech Atlas brings everything together in one place, making it easier for everyone to discover opportunities, connect with others, and contribute to the growth of Uganda's technology sector.
Tech Atlas serves as the definitive, community-owned platform for Uganda's tech ecosystem. The platform functions as digital infrastructure rather than a commercial product, treating ecosystem data as a public good that benefits everyone.
|
Interactive directory of tech hubs, communities, and startups with location-based mapping. Color-coded markers, automatic geocoding, and detailed profiles. Comprehensive listings for full-time jobs, internships, freelance opportunities, and paid tech help with advanced filtering. Curated resources spanning beginner to advanced levels with career roadmaps for Web Dev, Mobile, AI/ML, Data Science, and more. |
Centralized calendar of tech events, meetups, hackathons, grants, fellowships, and scholarships with searchable archive. Community-driven content including startup stories, career guidance, policy insights, and event recaps with Markdown support. Public showcase where users can create profiles highlighting their expertise, skills, and social links with modern profile cards. |
- π¬ Community Forum - Threaded discussions with categories, voting, and moderation
- π Role-Based Access Control - Multi-level user roles (Admin, Moderator, Editor, User, Guest)
- π Admin Dashboard - Comprehensive panel for content moderation and analytics
- π Interactive Map - Google Maps integration with location-based filtering
| Category | Technologies |
|---|---|
| Frontend | React 19, TypeScript, Tailwind CSS 4, Vite, Wouter (routing) |
| Backend | Node.js 22, Express 4, tRPC 11, Zod (validation) |
| Database | PostgreSQL, Supabase, Drizzle ORM |
| UI Components | shadcn/ui, Framer Motion, Lucide Icons |
| Authentication | Supabase Auth, JWT |
| Storage | Supabase Storage (avatars, images) |
| Maps | Google Maps JavaScript API |
| Testing | Vitest |
| Package Manager | pnpm |
Ensure you have the following installed:
- Node.js 22.x or higher
- pnpm package manager
- PostgreSQL database (or Supabase account)
# Clone the repository
git clone https://github.com/yourusername/tech-atlas-uganda.git
cd tech-atlas-uganda
# Install dependencies
pnpm installCreate a .env file in the root directory:
# Database Configuration
DATABASE_URL=postgresql://user:password@host:5432/database
# Supabase Configuration
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
# Frontend Environment Variables
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your-anon-key
# Google Maps API
VITE_GOOGLE_MAPS_API_KEY=your-google-maps-api-key
# Authentication
JWT_SECRET=your-jwt-secret
# Email Configuration (Optional)
RESEND_API_KEY=your-resend-api-key
# Analytics (Optional)
UMAMI_WEBSITE_ID=your-umami-website-id
VITE_UMAMI_WEBSITE_ID=your-umami-website-id# Push database schema
pnpm db:push
# Or run migrations
pnpm db:migrate# Start development server
pnpm dev
# Application will be available at http://localhost:3000# Run tests
pnpm test
# Run tests in watch mode
pnpm test:watch# Build for production
pnpm build
# Start production server
pnpm starttech-atlas-uganda/
βββ π client/ # Frontend React application
β βββ π public/ # Static assets (logo, favicon)
β βββ π src/
β βββ π components/ # Reusable UI components
β βββ π pages/ # Page-level components
β βββ π hooks/ # Custom React hooks
β βββ π contexts/ # React context providers
β βββ π lib/ # Utility libraries (tRPC client)
β βββ π App.tsx # Routes and layout
β βββ π main.tsx # Application entry point
β βββ π index.css # Global styles
β
βββ π server/ # Backend Express + tRPC server
β βββ π _core/ # Framework plumbing
β βββ π db.ts # Database query helpers
β βββ π routers.ts # tRPC procedure definitions
β βββ π *.test.ts # Backend tests
β
βββ π drizzle/ # Database schema and migrations
β βββ π schema-postgres.ts # PostgreSQL table definitions
β βββ π schema-simple.ts # Simplified schema
β
βββ π shared/ # Shared types and constants
β βββ π const.ts # Shared constants
β
βββ π package.json # Dependencies and scripts
βββ π vite.config.ts # Vite configuration
βββ π tailwind.config.ts # Tailwind CSS configuration
βββ π drizzle.config.ts # Drizzle ORM configuration
Tech Atlas is a community project and welcomes contributions from developers, designers, content creators, and anyone passionate about Uganda's tech ecosystem.
- π΄ Fork the repository and create a feature branch
- βοΈ Make your changes following the code style and conventions
- π§ͺ Write tests for new features or bug fixes
- π Update documentation if needed
- π Submit a pull request with a clear description of changes
- π» Code - Bug fixes, new features, performance improvements
- π¨ Design - UI/UX improvements, graphics, branding
- π Content - Blog posts, documentation, tutorials
- π Testing - Bug reports, test coverage, QA
- π Translation - Localization to local languages
- π Data - Ecosystem mapping, directory updates
For detailed guidelines, see CONTRIBUTING.md
Tech Atlas operates under transparent community governance principles. Major decisions are made through open discussion and consensus-building. The platform is maintained by core contributors with support from community moderators.
Community moderators help maintain content quality and adherence to community guidelines. Current moderators are listed on the Team page.
This project is open source and available under the MIT License. See the LICENSE file for details.
π Live Prototype: techatlasug.com
π§ Email: ronlinx6@gmail.com
π¬ Inquiries: For more information, partnerships, or support, reach out via email
Tech Atlas is built with support from Uganda's tech community and powered by open-source software. Special thanks to:
- π All contributors, moderators, and community members
- π» Open-source projects that make this possible
- πΊπ¬ Uganda's vibrant tech ecosystem
- π€ Partners and supporters who believe in our mission
- Interactive ecosystem mapping
- Jobs & gigs marketplace
- Learning hub with career roadmaps
- Events & opportunities calendar
- Community forum
- Talent directory
- Admin & moderator panel
- Mobile applications (iOS & Android)
- API for third-party integrations
- Advanced analytics dashboard
- Mentorship matching system
- Startup funding tracker
- Tech salary insights
- Newsletter system
- Multi-language support
Tech Atlas Uganda β’ Connecting Innovation, One Node at a Time