Skip to content

About

A modern, open-source platform designed to centralize and map Uganda's technology ecosystem. Connects communities, hubs, startups, jobs, learning resources, events, and opportunities with role-based access control, moderation, and community governance.

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

42 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—ΊοΈ Tech Atlas Uganda

Mapping and Connecting Uganda's Technology Ecosystem

Live Demo License Made in Uganda

Live Prototype β€’ Documentation β€’ Contributing β€’ Governance β€’ Contact


🌟 Overview

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.

🎯 Vision

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.


✨ Key Features

πŸ—ΊοΈ Ecosystem Mapping

Interactive directory of tech hubs, communities, and startups with location-based mapping. Color-coded markers, automatic geocoding, and detailed profiles.

πŸ’Ό Jobs & Gigs Marketplace

Comprehensive listings for full-time jobs, internships, freelance opportunities, and paid tech help with advanced filtering.

πŸ“š Learning Hub

Curated resources spanning beginner to advanced levels with career roadmaps for Web Dev, Mobile, AI/ML, Data Science, and more.

πŸ“… Events & Opportunities

Centralized calendar of tech events, meetups, hackathons, grants, fellowships, and scholarships with searchable archive.

✍️ Blog & Knowledge Base

Community-driven content including startup stories, career guidance, policy insights, and event recaps with Markdown support.

πŸ‘₯ Talent Directory

Public showcase where users can create profiles highlighting their expertise, skills, and social links with modern profile cards.

πŸ›‘οΈ Additional Features

  • πŸ’¬ 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

πŸš€ Technology Stack

Frontend

React TypeScript Tailwind CSS Vite

Backend

Node.js Express tRPC Drizzle ORM

Database & Infrastructure

PostgreSQL Supabase Google Maps

UI & Design

shadcn/ui Framer Motion Lucide Icons

πŸ› οΈ Complete Tech Stack

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

🏁 Getting Started

Prerequisites

Ensure you have the following installed:

  • Node.js 22.x or higher
  • pnpm package manager
  • PostgreSQL database (or Supabase account)

πŸ“¦ Installation

# Clone the repository
git clone https://github.com/yourusername/tech-atlas-uganda.git
cd tech-atlas-uganda

# Install dependencies
pnpm install

βš™οΈ Configuration

Create 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

πŸ—„οΈ Database Setup

# Push database schema
pnpm db:push

# Or run migrations
pnpm db:migrate

πŸš€ Development

# Start development server
pnpm dev

# Application will be available at http://localhost:3000

πŸ§ͺ Testing

# Run tests
pnpm test

# Run tests in watch mode
pnpm test:watch

πŸ“¦ Production Build

# Build for production
pnpm build

# Start production server
pnpm start

πŸ“ Project Structure

tech-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

🀝 Contributing

Tech Atlas is a community project and welcomes contributions from developers, designers, content creators, and anyone passionate about Uganda's tech ecosystem.

How to Contribute

  1. 🍴 Fork the repository and create a feature branch
  2. ✏️ Make your changes following the code style and conventions
  3. πŸ§ͺ Write tests for new features or bug fixes
  4. πŸ“ Update documentation if needed
  5. πŸš€ Submit a pull request with a clear description of changes

Contribution Areas

  • πŸ’» 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


πŸ›οΈ Community Governance

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.

Moderators

Community moderators help maintain content quality and adherence to community guidelines. Current moderators are listed on the Team page.


πŸ“„ License

This project is open source and available under the MIT License. See the LICENSE file for details.


πŸ“ž Contact

Get in Touch

🌐 Live Prototype: techatlasug.com

πŸ“§ Email: ronlinx6@gmail.com

πŸ’¬ Inquiries: For more information, partnerships, or support, reach out via email


Connect With Us

GitHub Twitter LinkedIn


πŸ™ Acknowledgments

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

πŸ—ΊοΈ Roadmap

Current Features βœ…

  • Interactive ecosystem mapping
  • Jobs & gigs marketplace
  • Learning hub with career roadmaps
  • Events & opportunities calendar
  • Community forum
  • Talent directory
  • Admin & moderator panel

Coming Soon πŸš€

  • 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

πŸ’– Built with Love for Uganda's Tech Ecosystem

Tech Atlas Uganda β€’ Connecting Innovation, One Node at a Time

Star on GitHub Follow on Twitter

⬆ Back to Top

About

A modern, open-source platform designed to centralize and map Uganda's technology ecosystem. Connects communities, hubs, startups, jobs, learning resources, events, and opportunities with role-based access control, moderation, and community governance.

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages