Stoxly - Stock Trading Platform

A full-stack stock trading platform for the Dhaka Stock Exchange (DSE) with real-time data, portfolio management, AI-powered insights, and advanced trading features.

Developer

Shanid Sajjatuz Islam

• Email: [email protected]
• LinkedIn: https://www.linkedin.com/in/shanid-sajjatuz-islam
• GitHub: https://github.com/perashanid

Features

Core Trading

• Real-time stock data from DSE
• Buy/Sell stock transactions
• Portfolio management and tracking
• Trade history and performance reports
• Limit orders with automatic execution
• Wishlist for tracking favorite stocks

Market Intelligence

• Live stock prices and market data
• Top 30 stocks by market cap
• Trending stocks analysis
• Earnings calendar
• News feed integration
• AI-powered stock insights and recommendations

Advanced Features

• Price alerts and notifications
• Real-time notification center
• Stock search with autocomplete
• Interactive charts and visualizations
• Export reports (PDF/CSV)
• Responsive modern UI with dark mode

Tech Stack

Backend

• Node.js + Express
• TypeScript
• MongoDB with Mongoose
• JWT Authentication
• Google Gemini AI
• Routing Controllers + TypeDI

Frontend

• React 18 + TypeScript
• Vite
• React Router v6
• TailwindCSS
• Chart.js + Recharts
• Framer Motion
• Lucide Icons

Prerequisites

• Node.js 18+ and npm
• MongoDB database
• Google Gemini API key
• NewsAPI key (optional)
• Financial Modeling Prep API key (optional)

Installation

1. Clone the repository

git clone https://github.com/perashanid/stoxly.git
cd stoxly

2. Install dependencies

npm install

3. Configure environment variables

cp .env.example .env

Edit .env with your configuration:

• MONGODB_URI: Your MongoDB connection string
• JWT_SECRET: Secret key for JWT tokens
• SESSION_SECRET: Secret key for sessions
• GEMINI_API_KEY: Google Gemini API key
• NEWS_API_KEY: NewsAPI key (optional)
• FMP_API_KEY: Financial Modeling Prep API key (optional)
• PORT: Server port (default: 3004)

4. Configure frontend environment

cd frontend
cp .env .env.local

Edit frontend/.env.local:

VITE_API_URL=http://localhost:3004

Development

Run both backend and frontend in development mode:

npm run dev

Or run them separately:

# Backend only
npm run dev:backend

# Frontend only
npm run dev:frontend

The application will be available at:

• Frontend: http://localhost:5173
• Backend API: http://localhost:3004

Production Build

Build the application:

npm run build

Start the production server:

npm start

Project Structure

├── src/                    # Backend source code
│   ├── controllers/        # API controllers
│   ├── services/          # Business logic
│   ├── models/            # MongoDB models
│   ├── middlewares/       # Express middlewares
│   ├── config/            # Configuration files
│   └── utils/             # Utility functions
├── frontend/              # Frontend application
│   ├── src/
│   │   ├── components/    # React components
│   │   ├── pages/         # Page components
│   │   ├── services/      # API services
│   │   ├── hooks/         # Custom React hooks
│   │   └── types/         # TypeScript types
│   └── public/            # Static assets
└── dist/                  # Compiled backend code

API Endpoints

Authentication

• POST /api/auth/register - Register new user
• POST /api/auth/login - Login user
• POST /api/auth/logout - Logout user
• GET /api/auth/me - Get current user

Stocks

• GET /api/stocks - Get all stocks
• GET /api/stocks/:symbol - Get stock details
• GET /api/stocks/top30 - Get top 30 stocks
• GET /api/stocks/trending - Get trending stocks

Portfolio

• GET /api/portfolio - Get user portfolio
• POST /api/portfolio/buy - Buy stocks
• POST /api/portfolio/sell - Sell stocks

Transactions

• GET /api/transactions - Get transaction history
• GET /api/transactions/export - Export transactions

Limit Orders

• GET /api/limit-orders - Get user limit orders
• POST /api/limit-orders - Create limit order
• DELETE /api/limit-orders/:id - Cancel limit order

Price Alerts

• GET /api/price-alerts - Get user price alerts
• POST /api/price-alerts - Create price alert
• DELETE /api/price-alerts/:id - Delete price alert

Wishlist

• GET /api/wishlist - Get user wishlist
• POST /api/wishlist - Add to wishlist
• DELETE /api/wishlist/:symbol - Remove from wishlist

News & Earnings

• GET /api/news - Get latest news
• GET /api/earnings - Get earnings calendar

AI Insights

• POST /api/ai/insights - Get AI-powered stock insights

Deployment

Render/Railway/Heroku

The project includes a render-build script for deployment:

npm run render-build

Environment Variables

Ensure all required environment variables are set in your deployment platform.

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

License

ISC

Support

For issues and questions, please open an issue on GitHub.